Флагманское качество
Seedream 5 Pro рендерит фотореалистичные сцены, предметную съёмку и точный текст на изображении в 1K и 2K — на уровне GPT Image и NanoBanana.
Гайд по Seedream 5 Pro API
Seedream 5 Pro — флагманская модель изображений ByteDance: сильная многоязычная отрисовка текста, редактирование по нескольким референсам, чистый фотореализм. На Seedance API модель доступна как стабильный алиас с простыми REST-эндпоинтами и посекундным polling'ом задач.
Вывод 1K или 2K
1:1, 16:9, 9:16, 2:3, 3:2 и др.
Промпт или до 10 референсов
JSON по HTTPS
Стартовый запрос
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, когда нужно флагманское качество картинки за предсказуемым REST-слоем — без SDK провайдера и внезапных смен схемы.
Seedream 5 Pro рендерит фотореалистичные сцены, предметную съёмку и точный текст на изображении в 1K и 2K — на уровне GPT Image и NanoBanana.
Вы вызываете model "seedream-5-pro". Маршрутизация, ёмкость и фолбэки остаются на нашей стороне — интеграция не зависит от апстрима.
9 кредитов за 1K, 18 за 2K, плюс 0.8 за каждый референс после первого. estimated_credits возвращается в каждом ответе создания.
Публичный интерфейс раскрывает реальные возможности модели: text-to-image и редактирование по референсам до десяти изображений.
Отправьте промпт до 3000 символов с пропорциями и разрешением — модель сама строит композицию, свет и текст на изображении.
Передайте 1–10 публичных HTTPS URL в image_urls для редактирования, композитинга или рестайлинга — замена продукта, фон, перенос стиля.
Установите resolution "2k" для печатного качества и финальных ассетов. 1K подходит для превью и итераций.
Одна из сильнейших сторон модели — читабельный текст на постерах и вывесках на английском, китайском, японском и других языках.
Создание сразу возвращает task_id — опрашивайте статус в своём ритме и держите UI отзывчивым без долгих соединений.
Структура ответа не зависит от апстрим-маршрутизации: consumed_credits, status и URL изображений нормализованы.
Три шага от API-ключа до готового URL изображения.
Войдите, откройте страницу API Keys и скопируйте ключ для серверного кода. Храните его на бэкенде — не в браузере.
Вызовите POST /v1/images/generations с model "seedream-5-pro", промптом, aspect_ratio, resolution и опциональным image_urls. В ответ — task_id и estimated_credits.
Вызовите GET /v1/images/generations/:task_id. При статусе SUCCESS читайте images[0].url и показывайте или сохраняйте результат.
Два эндпоинта покрывают весь жизненный цикл — создание и polling.
Создаёт задачу Seedream 5 Pro. Пустой image_urls — text-to-image; 1–10 URL — редактирование по референсам. Ответ 202 с task_id и estimated_credits.
Возвращает 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_urls | 0–10 публичных HTTPS URL. Пустой массив = чистый text-to-image. |
Неизвестные параметры отклоняются с 400 UNKNOWN_PARAMETER — контракт остаётся явным. Полная схема в /docs/images.
Фиксированная цена за изображение в кредитах Seedance API. Ответ создания содержит estimated_credits, финальный статус — consumed_credits.
| Режим | Кредиты | Примечания |
|---|---|---|
| Text-to-image · 1K | 9 кредитов / изображение | Разрешение по умолчанию — для итераций и превью. |
| Text-to-image · 2K | 18 кредитов / изображение | Печатное качество для финальных ассетов. |
| Редактирование по референсам | +0.8 кредита / доп. изображение | Первый референс включён в базовую цену; изображения 2–10 добавляют по 0.8. |
Ответы для разработчиков, оценивающих Seedream 5 Pro API на Seedance API.
Seedance API предоставляет Seedream 5 Pro за стабильным REST-слоем — полная функциональность модели с нормализованной авторизацией, биллингом и ответами без управления ключами провайдера.
Пустой массив image_urls — text-to-image. 1–10 публичных HTTPS URL — редактирование или композитинг по референсам. Один эндпоинт для обоих режимов.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 и 3:2. Выбирайте пропорцию под размещение — модель компонует кадр нативно, без кадрирования.
9 кредитов за 1K и 18 за 2K. Редактирование по референсам добавляет 0.8 кредита за каждое изображение после первого. estimated_credits виден до polling'а.
Обычно 15–25 секунд для 1K; 2K и мульти-референс дольше. Опрашивайте статус — задачи асинхронны по дизайну.
Нет — и не стоит. Держите Bearer-ключ на бэкенде, вызывайте наши эндпоинты с сервера и открывайте клиентам только свои безопасные маршруты.
Да — многоязычный текст на изображении одна из его сильных сторон: постеры, ценники и локализованная реклама с читабельным текстом.
Полная схема запроса, примеры ответов, таблица ошибок и детали цен — в /docs/images. Эта страница — обзор интеграции.
Получите API-ключ, отправьте первую задачу и подключите флагманскую генерацию изображений к своему продукту сегодня.