Генерация изображений Kling Image 4.0
Создание и редактирование одного изображения в 2K, 4K или 8K с помощью Kling Image 4.0
Для пользователей из материкового Китая: используйте 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_KEYBody
Отправьте запрос с типом 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[].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",
"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"
}
]
}
}