Гайд по Seedream 5 Pro API

Seedream 5 Pro API для генерации изображений

Seedream 5 Pro — флагманская модель изображений ByteDance: сильная многоязычная отрисовка текста, редактирование по нескольким референсам, чистый фотореализм. На Seedance API модель доступна как стабильный алиас с простыми REST-эндпоинтами и посекундным polling'ом задач.

Разрешение
1K / 2K

Вывод 1K или 2K

Пропорции
7

1:1, 16:9, 9:16, 2:3, 3:2 и др.

Вход
T2I + I2I

Промпт или до 10 референсов

Интерфейс
REST

JSON по HTTPS

Стартовый запрос

Создайте задачу Seedream 5 Pro

seedream-5-pro
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedream-5-pro",
    "prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
    "aspect_ratio": "4:3",
    "resolution": "2k",
    "image_urls": []
  }'

POST /v1/images/generations возвращает task_id. Опрашивайте GET /v1/images/generations/:task_id до статуса SUCCESS и читайте images[].url.

Зачем подключать Seedream 5 Pro API

Команды выбирают Seedream 5 Pro API, когда нужно флагманское качество картинки за предсказуемым REST-слоем — без SDK провайдера и внезапных смен схемы.

Флагманское качество

Seedream 5 Pro рендерит фотореалистичные сцены, предметную съёмку и точный текст на изображении в 1K и 2K — на уровне GPT Image и NanoBanana.

Один стабильный алиас

Вы вызываете model "seedream-5-pro". Маршрутизация, ёмкость и фолбэки остаются на нашей стороне — интеграция не зависит от апстрима.

Предсказуемая цена в кредитах

9 кредитов за 1K, 18 за 2K, плюс 0.8 за каждый референс после первого. estimated_credits возвращается в каждом ответе создания.

Возможности Seedream 5 Pro API

Публичный интерфейс раскрывает реальные возможности модели: text-to-image и редактирование по референсам до десяти изображений.

Text-to-image генерация

Отправьте промпт до 3000 символов с пропорциями и разрешением — модель сама строит композицию, свет и текст на изображении.

Редактирование по референсам

Передайте 1–10 публичных HTTPS URL в image_urls для редактирования, композитинга или рестайлинга — замена продукта, фон, перенос стиля.

Вывод 2K

Установите resolution "2k" для печатного качества и финальных ассетов. 1K подходит для превью и итераций.

Многоязычный текст

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

Асинхронные задачи

Создание сразу возвращает task_id — опрашивайте статус в своём ритме и держите UI отзывчивым без долгих соединений.

Стабильный формат ответа

Структура ответа не зависит от апстрим-маршрутизации: consumed_credits, status и URL изображений нормализованы.

Как вызвать Seedream 5 Pro API

Три шага от API-ключа до готового URL изображения.

1

Создайте API-ключ

Войдите, откройте страницу API Keys и скопируйте ключ для серверного кода. Храните его на бэкенде — не в браузере.

2

Отправьте задачу генерации

Вызовите POST /v1/images/generations с model "seedream-5-pro", промптом, aspect_ratio, resolution и опциональным image_urls. В ответ — task_id и estimated_credits.

3

Опрашивайте и рендерьте

Вызовите GET /v1/images/generations/:task_id. При статусе SUCCESS читайте images[0].url и показывайте или сохраняйте результат.

Справка по эндпоинтам

Два эндпоинта покрывают весь жизненный цикл — создание и polling.

POST /v1/images/generations

Создаёт задачу Seedream 5 Pro. Пустой image_urls — text-to-image; 1–10 URL — редактирование по референсам. Ответ 202 с task_id и estimated_credits.

GET /v1/images/generations/:task_id

Возвращает IN_PROGRESS, SUCCESS с images[].url или FAILED с объектом ошибки. После завершения показывает consumed_credits.

Ошибки и лимиты

400 неверные параметры, 401 неверный ключ, 402 мало кредитов, 404 задача не найдена, 429 rate limit, 503 апстрим недоступен. Полная таблица в документации.

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

ПараметрЗначение
modelТолько "seedream-5-pro" — единственная публичная модель на этом маршруте.
promptПромпт или инструкция редактирования, 1–3000 символов.
aspect_ratioОдно из: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. По умолчанию 1:1.
resolution"1k" (по умолчанию, 9 кредитов) или "2k" (18 кредитов).
image_urls0–10 публичных HTTPS URL. Пустой массив = чистый text-to-image.

Неизвестные параметры отклоняются с 400 UNKNOWN_PARAMETER — контракт остаётся явным. Полная схема в /docs/images.

Стоимость в кредитах

Фиксированная цена за изображение в кредитах Seedance API. Ответ создания содержит estimated_credits, финальный статус — consumed_credits.

РежимКредитыПримечания
Text-to-image · 1K9 кредитов / изображениеРазрешение по умолчанию — для итераций и превью.
Text-to-image · 2K18 кредитов / изображениеПечатное качество для финальных ассетов.
Редактирование по референсам+0.8 кредита / доп. изображениеПервый референс включён в базовую цену; изображения 2–10 добавляют по 0.8.

FAQ по Seedream 5 Pro API

Ответы для разработчиков, оценивающих Seedream 5 Pro API на Seedance API.

Это официальный API ByteDance Seedream 5 Pro?

Seedance API предоставляет Seedream 5 Pro за стабильным REST-слоем — полная функциональность модели с нормализованной авторизацией, биллингом и ответами без управления ключами провайдера.

Чем text-to-image отличается от редактирования по референсам?

Пустой массив image_urls — text-to-image. 1–10 публичных HTTPS URL — редактирование или композитинг по референсам. Один эндпоинт для обоих режимов.

Какие пропорции поддерживает Seedream 5 Pro?

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

Сколько стоит одно изображение Seedream 5 Pro?

9 кредитов за 1K и 18 за 2K. Редактирование по референсам добавляет 0.8 кредита за каждое изображение после первого. estimated_credits виден до polling'а.

Сколько занимает генерация?

Обычно 15–25 секунд для 1K; 2K и мульти-референс дольше. Опрашивайте статус — задачи асинхронны по дизайну.

Можно ли вызывать API из браузера?

Нет — и не стоит. Держите Bearer-ключ на бэкенде, вызывайте наши эндпоинты с сервера и открывайте клиентам только свои безопасные маршруты.

Умеет ли Seedream 5 Pro рисовать текст на изображении?

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

Где полная документация API?

Полная схема запроса, примеры ответов, таблица ошибок и детали цен — в /docs/images. Эта страница — обзор интеграции.

Создайте первое изображение Seedream 5 Pro

Получите API-ключ, отправьте первую задачу и подключите флагманскую генерацию изображений к своему продукту сегодня.