Image
Kling Image 4.0 Long Image
Создавайте длинные карточки товаров для e-commerce и макеты веб-страниц в разрешении 1K или 2K с Kling Image 4.0 Long Image, а затем опрашивайте статус задачи, чтобы получить URL готового PNG.
Отправьте JSON-запрос на POST /v1/images/generations с ID модели kling-image-4-0-long-image. Сохраните возвращённый ID задачи, а затем опрашивайте GET /v1/tasks/{id}, пока генерация длинного PNG не завершится.
Быстрый пример
Этот запрос создаёт макет веб-страницы в разрешении 1K по текстовому описанию. Сохраните 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-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'Конечная точка и заголовки
Отправьте JSON на POST https://api.seedrouter.ai/v1/images/generations с заголовками Content-Type: application/json и Authorization: Bearer YOUR_API_KEY. Храните ключ только на сервере.
Параметры
| Поле | Тип | Значения и значения по умолчанию |
|---|---|---|
model | string, обязательное | kling-image-4-0-long-image |
contents | array, обязательное | Один элемент prompt и элементы референсных изображений для выбранного режима. |
contents[].type | string, обязательное | prompt, refer_image (только для ecommerce, обязательно 1–3), style_refer_image (только для webpage, не более 1) или subject_refer_image (только для webpage, не более 1). Тип element не поддерживается. |
contents[].text | string | Обязательно для prompt. Лимит для текста на английском — 166 000 символов, для неанглийского — 71 000. Смешанный текст должен соответствовать формуле english / 166000 + non_english / 71000 <= 1. |
contents[].url | string | Обязательно для каждого изображения. Публичный HTTP(S) URL файла JPEG или PNG размером до 30 МБ, со стороной не менее 300 px и соотношением сторон от 2:5 до 5:2. |
contents[].id | string | Необязательный уникальный ID референса среди всех изображений запроса. Указывайте его в промпте как @id. |
settings.skill | string, обязательное | ecommerce для карточек товаров или webpage для макетов веб-страниц. |
settings.length | string | short (~2–5 секций), medium (по умолчанию, ~6–10 секций) или long (~11–18 секций). Применяется только для ecommerce; в режиме webpage не используется. |
settings.resolution | string | 1k (по умолчанию, ширина 1024 px) или 2k (ширина 2048 px). Высота адаптируется под содержание. Значение 4k не поддерживается. |
options.watermark_info.enabled | boolean | Необязательное. Поддерживается только false. |
Карточка товара для e-commerce
Режим ecommerce требует от 1 до 3 элементов refer_image. Ссылайтесь на каждое фото по его id в промпте.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}Дизайн веб-страницы с референсами стиля и объекта
Режим webpage принимает необязательные элементы style_refer_image (не более 1) и subject_refer_image (не более 1). В режиме webpage не передавайте settings.length.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}Получение готового длинного изображения
Скопируйте id из ответа на POST-запрос в переменную TASK_ID и опрашивайте задачу до статуса completed или failed. Генерация длинных изображений обычно занимает несколько минут, особенно для макетов long в разрешении 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"После завершения прочитайте output.data[0].url. Каждый запрос создаёт один цельный длинный PNG. В разрешении 2k объём файла может превышать 50 МБ, поэтому закладывайте достаточные таймауты загрузки и масштабирование при просмотре. Подробнее см. в справочнике задач и каталоге ошибок.
Цены
Каждый завершённый запрос оплачивается по тарифу выбранного уровня вывода (ecommerce по сочетанию resolution × length или webpage по resolution) плюс тариф за каждое входное изображение-референс (включая первое). За неудачный запрос плата не взимается. См. актуальные тарифы.
Ошибки и рекомендации
Некорректные запросы возвращают HTTP 400 до списания средств. Частые ошибки валидации: пропущено поле settings.skill, режим ecommerce без 1–3 URL в refer_image, использование refer_image в режиме webpage, запрос 4k или дублирующиеся ID референсов.
Указывайте точный порядок секций в промпте — от заглавного баннера до характеристик или подвала — и добавляйте только проверенные факты о товаре, чтобы макет оставался точным. Откройте Playground Kling Image 4.0 Long Image и схему OpenAPI.
