ToAPIsToAPIs
Kling Image 4.0

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

Создание и редактирование одного изображения в 2K, 4K или 8K с помощью Kling Image 4.0

POST
/v1/images/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

kling-image-4.0 создаёт изображения по текстовому описанию. Для редактирования или объединения элементов можно передать до 10 изображений-референсов. Каждый асинхронный запрос создаёт одно изображение в 2K, 4K или 8K.

Authorizations

Authorizationstringзаголовокобязательно

Все API требуют аутентификации Bearer Token

Получите API Key на странице управления API Key

Добавьте в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

Body

Отправьте запрос с типом application/json. Укажите поля на верхнем уровне тела запроса.

modelstringтелообязательнопо умолчанию: kling-image-4.0

Укажите kling-image-4.0.

promptstringтелообязательно

Опишите нужное изображение или изменения, которые следует внести в референсы. Укажите непустой текст.

resolutionstringтелопо умолчанию: 2K

Уровень разрешения. Допустимые значения 2K, 4K и 8K без учёта регистра.

aspect_ratiostringтелопо умолчанию: auto

Соотношение сторон результата. При auto модель выбирает пропорции. Доступные фиксированные соотношения 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.

sizestringтело

Псевдоним aspect_ratio с теми же допустимыми значениями. Если переданы оба поля, их значения должны совпадать.

nintegerтелопо умолчанию: 1

Количество изображений. Всегда равно 1. Опустите поле или передайте целое число 1.

image_urlsstring[]тело

До 10 изображений-референсов. Чтобы указать роль каждого изображения в промпте, используйте @image_1, @image_2 и далее по порядку массива. Передавайте доступные сервису HTTP- или HTTPS-ссылки на изображения. Для локального файла получите URL через API загрузки изображений.

Поддерживаются JPG, JPEG и PNG размером до 30 МБ на файл. Ширина и высота должны быть не менее 300 пикселей, а соотношение сторон должно быть в диапазоне от 2:5 до 5:2.

reference_imagesstring[]тело

Псевдоним image_urls. Используйте любое из этих двух полей.

callback_urlstringтело

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

Ограничения параметров

Этот метод создаёт одно стандартное изображение. Опустите поля исходного API Kling contents, options, settings, result_type и series_amount.

Получение задачи

Используйте полученный 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"

Оплата

Плата взимается за запрос. Тариф зависит от региона тарификации аккаунта и уровня разрешения. Соотношение сторон и количество референсов на тариф не влияют. См. фактическую стоимость и расход по задаче.

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",
  "prompt": "Красно-белый маяк на скалистом берегу. Морской туман рассеивается, и утренний свет освещает брызги волн.",
  "resolution": "2K",
  "aspect_ratio": "16:9"
}'
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",
  "prompt": "Поставьте настольную лампу с @image_1 в кабинет на @image_2. Сохраните форму и материал лампы, подстройте освещение и тени под комнату.",
  "resolution": "4K",
  "aspect_ratio": "4:3",
  "image_urls": [
    "https://example.com/lamp.png",
    "https://example.com/study.jpg"
  ]
}'

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

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "kling-image-4.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1794960000,
  "metadata": {}
}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "kling-image-4.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1794960000,
  "result": {
    "type": "image",
    "data": [
      {
        "url": "https://example.com/generated/kling-image-4.0.png"
      }
    ]
  }
}