Seedream 4.0

seedream-4.0 Seedream 4.0 предлагает обновленную генерацию изображений с улучшенным освещением, визуальными деталями и пониманием сложных промптов.

Эндпоинты

POST /v1/queue/seedream-4.0 # Создать задачу

GET /v1/queue/seedream-4.0/requests/{request_id}/status # Проверить статус

GET /v1/queue/seedream-4.0/requests/{request_id}/response # Получить результат

PUT /v1/queue/seedream-4.0/requests/{request_id}/cancel # Отменить задачу

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/seedream-4.0' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
  "image": "https://www.gstatic.com/webp/gallery/1.jpg",
  "sequential_image_generation": "disabled",
  "stream": false,
  "response_format": "url"
}'

prompt string required

Промпт для генерации изображения, поддерживает китайский и английский языки.

Рекомендуется не превышать 300 китайских иероглифов или 600 английских слов. Слишком длинный текст может рассеивать информацию, из-за чего модель может игнорировать детали и фокусироваться только на ключевых точках.

image string | array

Входные изображения. Поддерживается URL или Base64-кодирование, можно передать одно или несколько изображений.

URL изображения: убедитесь, что URL изображения доступен

Base64-кодирование: используйте формат data:image/<image_format>;base64,<Base64_encoding>. Значение <image_format> должно быть в нижнем регистре, например data:image/png;base64,<base64_image>.

Требования к изображению:

Поддерживаемые форматы: jpeg, png, webp, bmp, tiff, gif, heic, heif

Диапазон соотношения сторон (ширина/высота): от 1/16 до 16

Ширина и высота (px) > 14

Размер: не более 30MB

Общее число пикселей: не более 6000x6000=36000000 px. Ограничение применяется к произведению ширины и высоты одного изображения, а не к отдельным значениям ширины или высоты.

Поддерживается до 13 референсных изображений

size string

Размер генерируемого изображения. Поддерживаются два способа, их нельзя использовать одновременно.

Способ 1: укажите разрешение генерируемого изображения, а соотношение сторон, форму или назначение изображения опишите в prompt естественным языком.

Доступные значения: 1K, 2K, 4K

Способ 2: укажите ширину и высоту в пикселях.

Диапазон общего числа пикселей: от 1280x720=921600 до 4096x4096=16777216

Диапазон соотношения сторон: от 1/16 до 16

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

Корректный пример: 1600x600

Общее число пикселей 1600x600=960000 соответствует диапазону [921600, 16777216]. Соотношение сторон 1600/600=8/3 соответствует диапазону [1/16, 16], поэтому это значение корректно.

Некорректный пример: 800x800

Общее число пикселей 800x800=640000 ниже минимального требования 921600. Соотношение сторон 800/800=1 соответствует диапазону [1/16, 16], но значение не соблюдает оба ограничения одновременно, поэтому оно некорректно.

Рекомендуемые значения ширины и высоты в пикселях:

1K                  2K                  4K
1:1  1024x1024      1:1  2048x2048      1:1  4096x4096
4:3  1152x864       4:3  2304x1728      4:3  4704x3520
3:4  864x1152       3:4  1728x2304      3:4  3520x4704
16:9 1280x720       16:9 2848x1600      16:9 5504x3040
9:16 720x1280       9:16 1600x2848      9:16 3040x5504
3:2  1248x832       3:2  2496x1664      3:2  4992x3328
2:3  832x1248       2:3  1664x2496      2:3  3328x4992
21:9 1512x648       21:9 3136x1344      21:9 6240x2656

По умолчанию: 2048x2048

sequential_image_generation string

Управляет тем, отключать ли функцию генерации группы изображений.

Группа изображений: набор связанных по содержанию изображений, созданных на основе вашего ввода.

auto: автоматический режим, модель сама определяет, возвращать ли группу изображений и сколько изображений она будет содержать.

disabled: функция группы изображений отключена, модель генерирует только одно изображение.

Варианты: auto, disabled

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

sequential_image_generation_options object

Настройки функции группы изображений. Действуют только когда sequential_image_generation равно auto.

max_images integer

Максимальное число изображений, которое можно сгенерировать в этом запросе.

Фактическое число изображений также зависит от количества входных референсных изображений. Количество входных референсных изображений + итоговое число сгенерированных изображений ≤ 15.

Диапазон: от 1 до 15

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

stream boolean

Управляет включением потокового режима вывода.

false: непотоковый режим, вся информация возвращается один раз после завершения генерации всех изображений.

true: потоковый режим, результат каждого изображения возвращается сразу. Потоковый режим действует как для одного изображения, так и для группы изображений.

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

response_format string

Формат возврата сгенерированного изображения.

Сгенерированные изображения имеют формат JPEG; поддерживаются два способа возврата:

url: возвращает ссылку для скачивания изображения. Ссылка действительна 24 часа после генерации, скачайте изображение своевременно.

b64_json: возвращает данные изображения в формате JSON со строкой Base64.

Варианты: url, b64_json

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

watermark boolean

Добавлять ли водяной знак на сгенерированное изображение.

false: без водяного знака

true: добавить водяной знак "AI Generated" в правом нижнем углу

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

optimize_prompt_options object

Настройки функции оптимизации prompt.

mode string

Режим функции оптимизации prompt.

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

fast: быстрый режим, более короткое время обработки и обычное качество.

Варианты: standard, fast

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

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/seedream-4.0/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/seedream-4.0/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/seedream-4.0/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	ID задачи, используемый для последующих операций.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции