Seedream 5.5 AI

Документация для разработчиков

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

Создавайте изображения с Seedream 5 Pro через асинхронный API этого сайта. Seedream 5.5 остаётся предварительной версией и пока недоступна для вызова.

Быстрый старт

  1. Создайте ключ в разделе ключей API рабочего пространства.
  2. Отправьте model=seedream-5-pro и запрос в POST /api/v1/images/generate.
  3. Используйте полученный data.task_id для опроса GET /api/v1/images/status?task_id=TASK_ID с тем же ключом API.

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

Передавайте Authorization: Bearer YOUR_API_KEY со своего сервера. Сеанс браузера и Cookie не требуются. Храните ключ API в секрете.

Authorization: Bearer YOUR_API_KEY

Эндпоинты и поля запроса

POST /api/v1/images/generate

Отправьте JSON с model, prompt, aspect_ratio и resolution (1k или 2k). Необязательное поле image_urls принимает до 10 URL референсов; public — необязательное логическое значение. Ответ содержит code, message и data с task_id и status.

GET /api/v1/images/status?task_id=TASK_ID

Опрос по task_id возвращает code, message и data с task_id, status, consumed_credits и image_urls (массив URL изображений). При сбое задачи может присутствовать error_message.

Единственная доступная для вызова модель: seedream-5-pro

Продолжайте опрос, пока задача обрабатывается. После завершения прочитайте image_urls, а при сбое — error_message.

Пример cURL

Скопируйте команды в терминал, замените YOUR_API_KEY своим секретным ключом API, затем замените TASK_ID значением data.task_id из первого ответа.

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"Постер кофейни с чёткими разборчивыми надписями","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'