ByteDance

Seedream 5.0

seedream-5.0-lite/text-to-image

Производственная модель генерации изображений от ByteDance с поддержкой поиска в интернете и многошагового логического вывода, выводом в 4K и редактированием по образцу — подходит для создания карточек товаров и инфографики

seedream-5.0-flash seedream-5.0-lite/image-to-image seedream-5.0-lite/text-to-image seedream-5.0-pro/image-to-image seedream-5.0-pro/text-to-image

Попробовать seedream-5.0-lite/text-to-image

Ввод

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

Цены

seedream-5.0-lite/text-to-image per image

Цена за единицу	$0.035

Краткое описание позиционирования

Линия генерации изображений по тексту Seedream 5.0 Lite — версия серии ByteDance Seedream 5.0, ориентированная на сценарии облегчённого производства. Она принимает текстовое описание и выдаёт изображение в разрешении 2K или 4K с заданным соотношением сторон; длина промпта — до 3000 символов. Подходит разработчикам, которым нужно массово создавать типовые иллюстрации и быстро проверять визуальные решения. По сравнению с версией Pro той же серии она лучше подходит для этапов работы с изображениями, чувствительных к стоимости одного изображения; для сложных инфографик, плотной текстовой вёрстки или согласованного редактирования нескольких изображений следует использовать более мощную линию.

Ключевые особенности

Поддержка актуальных знаний из интернета в промпте — когда промпт касается актуальных тем, модель может учитывать сетевую информацию для понимания замысла, снижая искажения из-за устаревших данных.
Разрешения 2K и 4K по одной цене — переключение между 2K и 4K не меняет принцип тарификации, и за высокодетализированный результат не нужно отдельно планировать расходы.
Соотношения сторон охватывают основные форматы размещения — доступно восемь соотношений сторон от 1:1 до 21:9, что позволяет за один вызов сразу получать композиции под разные площадки.

Описание возможностей

Генерация изображения только по тексту: изображение создаётся исключительно по текстовому описанию, без загрузки референсных изображений; удобно сначала быстро задать словами визуальное направление, а затем отобрать лучшие варианты.

Вывод в разрешении 2K/4K: стандартный или высокодетализированный режим выбирается по необходимости; режим 4K подходит для готовых материалов, которые нужно рассматривать с увеличением или показывать в печатном качестве.

Восемь соотношений сторон: доступны 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 — они напрямую соответствуют форматам для соцсетей, баннеров и вертикальных площадок.

Длинный ввод промпта: длина промпта — до 3000 символов, что позволяет вместить достаточно полное описание сцены, стиля и композиции и удобно для накопления переиспользуемых шаблонов промптов.

Сценарии применения

Электронная коммерция: преимущества товара и описание сцены — массовая генерация главных изображений товаров и маркетинговых иллюстраций по текстовому описанию для страниц каталога магазина или черновиков рекламных материалов.
Контент-команды: иллюстрации к статьям и мероприятиям — по теме и требованиям к изображению создаются иллюстрации в нескольких соотношениях сторон для заголовочных изображений статей, баннеров и постов в соцсетях.
Продукт и дизайн: предварительная проработка визуальных решений — до начала официального дизайна быстро генерируются эскизы в нескольких направлениях по тексту для обсуждения требований и подтверждения стиля.
Разработчики приложений: интеграция функции генерации изображений — через единый интерфейс возможность генерации изображений по тексту встраивается в собственный продукт, а изображения создаются в реальном времени по промптам пользователей.

Ограничения и рекомендации по выбору

Эта линия принимает только текстовый ввод и не поддерживает перенос стиля по референсному изображению, локальное редактирование или объединение нескольких изображений; когда требуются редактирование изображений и контроль согласованности, следует использовать линию генерации изображений по изображению той же серии. Для задач со сложной инфографикой и плотной текстовой вёрсткой, где важна точность отрисовки текста, лучше выбрать версию Pro: в ней отдельно усилены структурная связность и многоязычная передача текста. Кроме того, промпты, связанные с текущими событиями, подключают сетевую информацию, и результат зависит от найденного контента; если требуется строгая воспроизводимость, это следует явно ограничить в промпте.

Новости

Смотреть changelog →

Новая модель Запуск seedream-5.0-pro/image-to-image Nov 3, 2026
Новая модель Новая модель доступна: seedream-5.0-pro/text-to-image Nov 3, 2026
Новая модель Модель seedream-5.0-lite/image-to-image теперь доступна Nov 3, 2026

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: seedream-5.0-lite/text-to-image

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для seedream-5.0-lite/text-to-image и маршрута default — см. таблицу параметров ниже.

promptstringОбязательноminLength 4maxLength 3000

Текстовое описание для генерации изображения. Модель понимает замысел промпта и может привлекать актуальные знания из интернета.

resolutionstringОбязательноПо умолчанию: "2K"

Уровень разрешения выходного изображения: 2K — стандартное качество, 4K — максимальная детализация; обе опции стоят одинаково. По умолчанию 2K.

Варианты:2K4K

aspect_ratiostringОбязательноПо умолчанию: "1:1"

Соотношение сторон выходного изображения. По умолчанию 1:1.

Варианты:1:14:33:416:99:162:33:221:9

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

Примеры запроса

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.0-lite/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedream-5.0-lite/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedream-5.0-lite/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

Примеры ответа

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}