Генерация длинных изображений Kling Image 4.0
Создайте длинный макет веб-страницы или изображение для карточки товара в 1K или 2K
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
kling-image-4.0-long асинхронно создаёт одно длинное изображение за запрос. Выберите webpage для макета веб-страницы или ecommerce для изображения с описанием товара.
Authorizations
AuthorizationstringзаголовокобязательноВсе API требуют аутентификации Bearer Token
Получите API Key на странице управления API Key
Добавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEYBody
Отправьте запрос с типом application/json. Укажите поля на верхнем уровне тела запроса.
modelstringтелообязательнопо умолчанию: kling-image-4.0-longУкажите kling-image-4.0-long.
promptstringтелообязательноНепустое текстовое описание компоновки и содержимого изображения.
skillstringтелообязательноwebpage создаёт макет веб-страницы. ecommerce создаёт длинное изображение с описанием товара.
resolutionstringтелопо умолчанию: 1KВыберите 1K или 2K. Регистр не учитывается.
nintegerтелопо умолчанию: 1Количество изображений. Всегда равно 1. Опустите поле или передайте целое число 1.
lengthstringтелоТолько для ecommerce. short даёт около 2-5 разделов. Для medium (по умолчанию) их около 6-10, для long около 11-18. Все разделы объединяются в одном изображении.
image_urlsstring[]телоДля ecommerce передайте от 1 до 3 изображений товара в нужном порядке в этом поле или в reference_images. Ссылки @image_1, @image_2 и @image_3 в промпте соответствуют порядку изображений в массиве.
reference_imagesstring[]телоДля ecommerce это поле можно передать вместо image_urls. Используйте только одно из двух полей.
style_reference_image_urlstringтелоНеобязательное поле только для webpage. URL одного изображения, задающего визуальный стиль.
subject_reference_image_urlstringтелоНеобязательное поле только для webpage. URL одного изображения, задающего основной объект.
callback_urlstringтелоНеобязательный URL для уведомления о завершении задачи. При настроенном вебхуке задач для токена используйте схему, хост и порт URL по умолчанию. Если поле опущено, используется включённый для токена адрес по умолчанию.
Укажите HTTP(S) URL изображений, доступные сервису. Чтобы получить URL локального файла, воспользуйтесь API загрузки изображений.
Ограничения параметров
Для webpage полностью опустите length, image_urls и reference_images. Пустые массивы и null тоже отклоняются. Если опустить обе ссылки на изображения, результат будет создан только по тексту. Для ecommerce опустите style_reference_image_url и subject_reference_image_url.
Поля size, aspect_ratio, ratio, series_amount, result_type, contents, options и settings следует опустить.
Получение задачи
Используйте полученный id и тот же API-ключ, чтобы проверить задачу генерации. Статусы queued и in_progress означают, что задача ещё выполняется. При completed URL изображения доступен в result.data[0].url, при failed сведения об ошибке доступны в error.
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"Оплата
Базовая стоимость одного запроса зависит от региона тарификации, skill и resolution. Для ecommerce цена также зависит от length. Вызовите GET /v1/pricing?model=kling-image-4.0-long с тем же API-ключом. Добавьте ®ion=cn для каталога материкового Китая или ®ion=global для международного каталога. По умолчанию используется global независимо от домена API.
Если подходящая запись цены содержит input_image_unit_price, каждое изображение-референс сверх free_input_image_count оплачивается отдельно. Подтверждённая сумма указана в поле billing задачи. См. фактическую стоимость и расход по задаче.
Response
idstringУникальный идентификатор задачи для запроса статуса
objectstringТип объекта, всегда generation.task
modelstringНазвание используемой модели
statusstringПосле принятия запроса возвращается queued.
progressintegerПрогресс задачи в процентах (0-100)
created_atintegerВременная метка создания задачи (Unix timestamp)
metadataobjectМетаданные задачи
result.data[].urlstringURL единственного изображения в завершённой задаче.
Перед запуском задайте переменную окружения TOAPIS_API_KEY. Замените адреса референсов на example.com доступными URL изображений.
Пример запроса
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0-long",
"prompt": "Создайте длинную посадочную страницу для гончарной студии. Возьмите оформление из изображения стиля, а кружку ручной работы из изображения основного объекта. Добавьте расписание занятий и раздел записи.",
"skill": "webpage",
"n": 1,
"resolution": "1K",
"style_reference_image_url": "https://example.com/pottery-style.png",
"subject_reference_image_url": "https://example.com/handmade-mug.png"
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0-long",
"prompt": "Создайте длинное изображение для карточки настольной лампы из @image_1. Покажите панель управления крупным планом с помощью @image_2. Добавьте разделы о настройках яркости, размерах и комплектации.",
"skill": "ecommerce",
"n": 1,
"resolution": "2K",
"length": "medium",
"image_urls": [
"https://example.com/desk-lamp.png",
"https://example.com/lamp-controls.png"
]
}'Пример ответа
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0-long",
"status": "queued",
"progress": 0,
"created_at": 1794960000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0-long",
"status": "completed",
"progress": 100,
"created_at": 1794960000,
"metadata": {},
"result": {
"type": "image",
"data": [
{
"url": "https://example.com/generated/kling-image-4.0-long.png"
}
]
}
}