API

Seedream 5.0 Pro API

Изображение

API Seedream 5.0 Pro поддерживает генерацию изображений из текста и редактирование по референсам с гибким соотношением сторон и выводом в 1K или 2K.

Авторизация

Bearerstringheaderобязательно

API-ключ для авторизации запросов

Тело

application/json

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

seedream-5-0-pro

input.promptstringобязательно

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

input.imagesstring[]необязательно

Необязательные URL референсных изображений. Используйте только общедоступные HTTPS URL. Для генерации изображений по тексту поле можно не передавать.

Максимум 16 элементов.

input.aspect_ratiostringнеобязательно

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

По умолчанию: 1:1

1:116:99:163:22:33:44:321:9

input.resolutionstringнеобязательно

Разрешение изображения. Используйте значения 1k или 2k в нижнем регистре. По умолчанию: 1k.

По умолчанию: 1k

1k2k

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

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "Кинематографичная продуктовая фотография футуристической камеры в форме банана",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedream-5-0-pro",
    "status": "processing",
    "credits": 50
  }
}

Опрашивайте этот endpoint с возвращённым ID задачи до её завершения или ошибки. Рекомендуем выполнять polling каждые 5 секунд для получения актуального статуса.

POST /api/v1/check

{
  "task_id": "task_example"
}

Ответ

Статус задачи, возвращаемый POST /api/v1/check. ID, URL и временные метки ниже приведены для примера.

idstringобязательно

Идентификатор задачи в data.id совпадает с task_id в запросе проверки.

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

completed означает успешную генерацию, а data.data содержит результаты. При других статусах data.data равно null.

failed_reasonstringнеобязательно

Возвращается только при status failed и объясняет причину ошибки. Для completed и processing это поле отсутствует.

Завершено · completed

Ссылки для скачивания находятся в data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Другие статусы

При processing или failed значение data.data равно null. Этот пример показывает failed: только failed содержит failed_reason. При processing продолжайте проверку, при failed прекратите её.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Расход кредитов

Расход кредитов на запрос, создающий одно изображение.

Расход кредитов на запрос, создающий одно изображение.
Разрешение	1K	2K
Одно изображение	50	100

Необязательные параметры не указаны: 50 кредитов

Явно укажите перечисленные параметры input, чтобы использовать соответствующий тариф. Запросы на несколько изображений могут расходовать больше кредитов.

Поле credits в ответе POST /api/v1/create показывает число кредитов, списанных за задачу.