API изображений Seedream 5

Документация API

Используйте эти эндпоинты для асинхронного создания изображений Seedream 5. Расход кредитов зависит от качества и режима.

Аутентификация

Все запросы должны включать ваш ключ API внутри Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Отсутствующие или недействительные ключи возвращают 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

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

Отправляет новое задание Seedream 5. Вызов немедленно возвращает task_id, в то время как рендеринг завершается асинхронно.

Параметр	Тип	Обязательный	Описание
prompt	string (max 1500 chars)	Да	Основное текстовое описание (до 1500 символов). Обязательно для каждого запроса.
aspectRatio	string	Да	Поддерживаемые форматы: 1:1 · 3:4 · 4:3 · 9:16 · 16:9.
quality	string (basic \| high)	Да	basic (быстро, 2K) или high (детальнее, 4K).
imageUrls	string[]	Нет	Необязательные референсные изображения. Обязательны для режима редактирования.

Потребление кредитов

Кредиты списываются при создании задачи. Сбойные задания автоматически возвращаются (происходит возврат средств).

Предустановка	Списано кредитов
Текст в изображение · Basic	12
Текст в изображение · High	18
Редактирование с референсом · Basic	18
Редактирование с референсом · High	24
Серия из 4 изображений (один запрос)	48

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

POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
  "aspectRatio": "4:3",
  "quality": "high",
  "imageUrls": []
}

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

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71"
  }
}

GET / POST

https://seedream45ai.org/api/status

Проверка статуса задачи

Используйте эту конечную точку для опроса последней записи. Когда задача все еще находится в статусе IN_PROGRESS, мы запрашиваем провайдера еще раз перед ответом.

Параметр	Тип	Обязательный	Описание
task_id	string	Да	ID из /generate. Передайте его в запросе (?task_id=) к /status.

Поле	Описание
task_id	ID, возвращенный /generate.
status	SUCCESS (УСПЕХ)
request	Очищенная копия отправленной полезной нагрузки.
response	Массив URL-адресов медиафайлов, когда status - SUCCESS.
consumed_credits	Кредиты, списанные за задачу (0 при возврате средств).
error_message	Ошибка провайдера, когда status - FAILED.
created_at	Метка времени UTC, когда задание было сохранено.

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

GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>

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

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71",
    "status": "SUCCESS",
    "request": {
      "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
      "aspectRatio": "4:3",
      "quality": "high"
    },
    "response": [
      "https://watch_001.png"
    ],
    "consumed_credits": 12,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Обработка ошибок

401 Unauthorized - Отсутствует или недействителен ключ API.
402 Payment Required - Кредитный баланс не смог покрыть списание.
429 Too Many Requests - Уменьшите частоту опроса или скорость запросов.
500 - Временная проблема; повторите попытку с экспоненциальной задержкой.