Claude Opus 5.5 уже доступна в SeedRouter

Image

Kling Image 4.0

View Markdown

Создавайте изображения в разрешении 2K или 4K с Kling Image 4.0. Используйте именованные референсные фотографии, создавайте отдельные варианты или связанную серию, а затем проверяйте статус задачи, чтобы получить URL готовых изображений.

Отправьте JSON-запрос на POST /v1/images/generations с ID модели kling-image-4-0. Сохраните ID задачи из ответа. Эта же конечная точка принимает описания как без референсов, так и с ними.

Быстрый пример

Этот запрос создаёт одно квадратное изображение в разрешении 2K. Сохраните API-ключ в переменной окружения SEEDROUTER_API_KEY.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0",
    "contents": [
      {"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
    ],
    "settings": {"resolution": "2k", "aspect_ratio": "1:1"}
  }'

Конечная точка и заголовки

POST https://api.seedrouter.ai/v1/images/generations — конечная точка, на которую отправьте JSON с заголовками Content-Type: application/json и Authorization: Bearer YOUR_API_KEY. Храните ключ на своём сервере.

Параметры

ПолеТипДопустимые значения и значения по умолчанию
modelстрока, обязательный параметрkling-image-4-0
contentsмассив, обязательный параметрОдин промпт и от нуля до десяти референсных изображений.
contents[].typeстрока, обязательный параметрprompt или refer_image.
contents[].textстрокаОбязательно для промпта. Лимит для английского текста — 50 000 символов, для текста на других языках — 21 000. В смешанном тексте сумма долей от соответствующих лимитов не должна превышать единицу.
contents[].urlстрокаОбязательно для каждого референса. Укажите доступный URL HTTP(S) JPEG- или PNG-файла размером до 30 МБ. Обе стороны изображения должны быть не меньше 300 пикселей, а соотношение ширины и высоты — от 2:5 до 5:2.
contents[].idстрокаНеобязательное уникальное имя референса. Упомяните его в промпте в виде @name.
settings.result_typeстрокаsingle (по умолчанию) — для независимых изображений; series — для связанных изображений.
settings.nцелое числоОт 1 до 9 независимых изображений. По умолчанию — 1. Используется только в режиме single.
settings.series_amountцелое число или строкаВ режиме series создаётся от 2 до 4 изображений, по умолчанию — 4. В режиме single поле игнорируется; допустимое значение — целое число от 2 до 10 или строка auto.
settings.resolutionстрока2k (по умолчанию) или 4k.
settings.aspect_ratioстрокаauto (по умолчанию), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 или 21:9.
options.watermark_info.enabledлогическое значениеНеобязательный параметр. Поддерживается только значение false.

Серия на основе референсной фотографии

Замените пример URL общедоступным URL фотографии своего продукта. В этом примере запрашиваются три связанных изображения. Инструкцию для каждого кадра включите в тот же промпт.

{
  "model": "kling-image-4-0",
  "contents": [
    {"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
    {"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
  ],
  "settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}

Получение всех изображений

Скопируйте id из ответа POST в TASK_ID. Отправляйте запросы на эту конечную точку с тем же ключом, пока статус задачи не станет completed или failed.

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

После завершения прочитайте все URL в output.data[].url. Одна задача может вернуть несколько изображений. Если проверка статуса прервалась, снова запросите данные по исходному ID. О жизненном цикле задачи см. в справочнике по задачам, а коды ошибок перечислены в справочнике ошибок.

Стоимость

Общая стоимость складывается из стоимости всех выходных изображений в запрошенном разрешении по текущему тарифу и платы за каждое входное референсное изображение. Четыре изображения в разрешении 4K с двумя референсами стоят как четыре выходных изображения 4K и два референса. За неудачный запрос плата не взимается. См. текущие тарифы.

Ошибки и советы

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

Для описания с несколькими референсами используйте для каждого объекта отдельное имя и укажите, какие визуальные особенности нужно взять из каждого референса. Добавьте в промпт указания по камере и последовательности кадров. См. песочницу Kling Image 4.0 и схему OpenAPI.