ToAPIsToAPIs
Kling Image 4.0

Генерация длинных изображений Kling Image 4.0

Создайте длинный макет веб-страницы или изображение для карточки товара в 1K или 2K

POST
/v1/images/generations

Для пользователей из материкового Китая: используйте 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_KEY

Body

Отправьте запрос с типом 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-ключом. Добавьте &region=cn для каталога материкового Китая или &region=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[].urlstring

URL единственного изображения в завершённой задаче.

Перед запуском задайте переменную окружения 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"
      }
    ]
  }
}