Kling Image 4.0 от Kuaishou (Beta): текст в изображение и генерация по референсам (до 10), 2K / 4K в 8 пропорциях, оригинальный PNG с учётными данными контента C2PA. Сильные стороны — реалистичная фактура и текст на изображении, включая китайский.
Попробовать в песочнице →Быстрый старт
Три шага: отправить задачу, опросить её и забрать ссылку на изображение. Замените YOUR_API_KEY своим ключом, и команды ниже заработают как есть.
Шаг 1 · Отправка (сразу возвращает id задачи, HTTP 202)
curl https://kovapi.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "kling-image-4.0", "prompt": "Постер распродажи к Празднику середины осени, крупный заголовок «Полная луна — вся семья вместе» в центре, ниже «Скидка 20% на всё», тёплые золотые тона, полная луна и османтус", "size": "16:9", "resolution": "2K"}'Ответ (HTTP 202)
{
"id": "img_7f3c9a1e2b4d6f8a0c1e3b5d",
"object": "image.generation.job",
"status": "queued",
"created": 1791281400,
"model": "kling-image-4.0"
}Шаг 2 · Опрашивайте каждые 2–3 секунды, пока status не станет succeeded или failed
curl https://kovapi.com/v1/images/jobs/img_7f3c9a1e2b4d6f8a0c1e3b5d \ -H "Authorization: Bearer YOUR_API_KEY"
Ответ при успехе
{
"id": "img_7f3c9a1e2b4d6f8a0c1e3b5d",
"object": "image.generation.job",
"status": "succeeded",
"created": 1791281400,
"model": "kling-image-4.0",
"data": [
{"url": "https://img.kovapi.com/i/2be8cd16d37f3a4b9c0e1f2a3b4c5d6e.png"}
],
"usage": {"images": 1, "resolution": "2K", "model": "kling-image-4.0"}
}Шаг 3: скачайте data[0].url — оригинальный PNG от Kling (с учётными данными контента C2PA); 4K весит около 30 МБ и хранится 7 дней.
Полный пример (Python: отправить, дождаться, сохранить на диск)
import time
import requests
BASE = "https://kovapi.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
# 1. отправка
job = requests.post(f"{BASE}/images/generations", headers=HEADERS, json={
"model": "kling-image-4.0",
"prompt": "Постер распродажи к Празднику середины осени, крупный заголовок «Полная луна — вся семья вместе» в центре, ниже «Скидка 20% на всё», тёплые золотые тона, полная луна и османтус",
"size": "16:9",
"resolution": "2K",
}).json()
if "error" in job:
raise SystemExit(job["error"]["message"])
# 2. опрос каждые 3 секунды до завершения
while job["status"] not in ("succeeded", "failed"):
time.sleep(3)
job = requests.get(f"{BASE}/images/jobs/{job['id']}", headers=HEADERS).json()
# 3. скачивание изображения
if job["status"] == "succeeded":
url = job["data"][0]["url"]
with open("kling-image-4.0.png", "wb") as f:
f.write(requests.get(url).content)
print("saved", url)
else:
print("failed:", job["error"]["code"], job["error"]["message"])Аутентификация
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Чтобы начать, создайте API-ключ в консоли.
Параметры запроса
JSON-тело запроса POST /v1/images/generations:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| model | string | Да | ID модели: kling-image-4.0. |
| prompt | string | Да | Что нарисовать. Для изображения из изображения опишите, что нужно изменить. |
| size | string | Нет | Пропорция: 1:1 (по умолчанию), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9. Размер в пикселях (например, 2720x1536) сопоставляется по пропорции с одной из этих 8; другая пропорция — 400 при отправке, ничего не списывается. |
| resolution | string | Нет | Уровень: 2K (по умолчанию) или 4K; 1K и 8K нет (1K — 400 при отправке, ничего не списывается). |
| image / images | string / array | Нет | Референсы: один в image, несколько в images, до 10, как URL изображения, data: URI или base64; jpg / png, не меньше 300 px по каждой стороне, соотношение сторон от 2:5 до 5:2. Называйте их в промпте по порядку @image1, @image2 и пишите, для чего каждый. Каждый референс стоит на $0.003 больше. |
| n | integer | Нет | Одно изображение за запрос: n должно быть 1. Для нескольких изображений отправьте несколько заданий. |
| callback_url | string | Нет | Куда отправить результат, когда задача завершится; подробнее — в разделе о вебхуках ниже. |
Остальные параметры OpenAI (quality, style, background, response_format и другие) не действуют. Каждый запрос даёт один оригинальный PNG; каждый референс стоит на $0.003 больше и резервируется вместе с изображением при отправке.
Цена
Оплата за изображение; цена зависит только от уровня, а пропорция и режим (из текста или из изображения) на неё не влияют. Цена уровня резервируется при отправке и полностью возвращается, если задача завершится ошибкой. 1 кредит = $0.005.
| Уровень | Кредитов за изображение | USD за изображение |
|---|---|---|
| 2K | 12 | $0.06 |
| 4K | 18 | $0.09 |
Пропорции, разрешение и размер изображения
У каждой пропорции и уровня один фиксированный родной размер (замеры 11-20); вы получаете оригинал без обрезки и масштабирования. 4K вдвое больше 2K по каждой стороне.
| Пропорция | 2K | 4K |
|---|---|---|
| 1:1 | 2048x2048 | 4096x4096 |
| 16:9 | 2720x1536 | 5440x3072 |
| 9:16 | 1536x2720 | 3072x5440 |
| 4:3 | 2336x1760 | 4672x3520 |
| 3:4 | 1760x2336 | 3520x4672 |
| 3:2 | 2496x1664 | 4992x3328 |
| 2:3 | 1664x2496 | 3328x4992 |
| 21:9 | 3136x1326 | 6272x2651 |
- Только эти 8 пропорций; любая другая (9:21, 1:2 и т. п.) — 400 при отправке, ничего не списывается.
- size принимает и размер в пикселях (например,
5440x3072): он сопоставляется с таблицей по пропорции, длинная сторона больше 3200 px — это 4K, иначе 2K; если указан resolution, решает он.
Изображение из изображения и референсы
- Передайте
image(одно изображение) илиimages(несколько, до 8; сверх 8 не используются) — и задача выполнится как изображение из изображения; в промпте напишите, что изменить.POST /v1/images/editsпринимает те же параметры. - Оба эндпоинта принимают только JSON-тело, а не загрузку файлов через multipart, поэтому
images.edit()из OpenAI SDK напрямую не подойдёт: передавайте ссылки или base64, как в примере ниже. - Каждый референс — это публичная ссылка на изображение (http или https), data: URI или просто base64, до 16MB каждый, в распространённом формате: JPEG, PNG, WebP и т. п.
- Ссылка должна отдавать само изображение, а не веб-страницу и не адрес за логином или с защитой от хотлинка. Референс, который не удаётся прочитать, отклоняется при отправке с ошибкой 400, где указано, какой именно и почему; задача не создаётся, ничего не списывается.
- До 10 референсов (jpg / png, не меньше 300 px по стороне, соотношение 2:5–5:2); называйте их по порядку @image1, @image2 и пишите, для чего каждый; неупомянутые референсы тоже учитываются. Каждый референс стоит на $0.003 больше.
- Референсы мы размещаем у себя и храним 7 дней.
Изображение из изображения по двум референсам
curl https://kovapi.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "kling-image-4.0", "prompt": "Сохрани людей, замени фон на ночной пляж с гирляндами тёплого света", "images": ["https://example.com/people.jpg", "https://example.com/beach.jpg"], "size": "3:4", "resolution": "2K"}'Статус задачи и поля ответа
GET /v1/images/jobs/{id} возвращает эти статусы; все поля описаны в разделе Асинхронные задачи. Опрашивайте каждые 2–3 секунды или используйте вебхук.
| Статус | Что значит |
|---|---|
| queued | В очереди. В ответе есть queue_position (сколько задач впереди) и eta_seconds (ожидаемое время ожидания). |
| processing | Генерируется. |
| succeeded | Готово. Результат в data[0].url, детали оплаты в usage. |
| failed | Ошибка. Причина в error; зарезервированные кредиты возвращаются полностью. |
Один аккаунт выполняет до 50 задач одновременно; остальные ждут в порядке отправки, а задача, не начавшаяся за 15 минут, завершается ошибкой с полным возвратом. Записи о задачах хранятся 3 дня, ссылки на изображения — 7 дней.
Сколько ждать
Замеры 11-20: 2K за 33–52 с, 4K за 57–74 с, 2K с двумя референсами около 70 с; в часы пик — дольше.
Ошибки и возвраты
Ошибка при отправке сразу возвращается как HTTP 4xx / 5xx: задача не создаётся, ничего не списывается. О неудаче после того, как задача принята, сообщает эндпоинт задачи, а резерв возвращается полностью. Все коды перечислены в разделе Коды ошибок.
Ошибки при отправке
| HTTP | code | Причина | Что делать |
|---|---|---|---|
| 400 | missing_prompt | В запросе к /v1/images/generations нет prompt. | Добавьте prompt. |
| 400 | invalid_request | Не удаётся прочитать референсное изображение (битая ссылка, не изображение, больше 16MB…; в message указано, какое и почему), в /v1/images/edits нет референсного изображения, тело запроса — не JSON-объект или n — не целое число. | Исправьте то, что указано в message, и отправьте снова. |
| 400 | model_not_found | ID модели написан с ошибкой, model не передан или модель нельзя использовать на этом эндпоинте (например, чат-модель на эндпоинте изображений). | Берите ID модели из GET /v1/models или из справочника API. |
| 401 | invalid_api_key | Ключ не существует, удалён или отключён, либо отключён аккаунт. | Проверьте ключ на странице API Keys в консоли. |
| 402 | insufficient_quota | Баланса не хватает, чтобы зарезервировать стоимость этого запроса. Шлюз сначала резервирует максимально возможную стоимость запроса, поэтому ошибка может возникнуть и при всплеске одновременных вызовов. | Если был всплеск запросов, подождите несколько секунд и повторите; в остальных случаях пополните баланс. |
| 429 | rate_limit_exceeded | Превышен лимит запросов в минуту, заданный для этого ключа (считается за последние 60 секунд). Заголовка Retry-After нет. | Подождите несколько секунд и повторите или увеличьте лимит ключа в консоли. |
| 503 | model_maintenance | Модель на обслуживании и не принимает запросы; пока идёт обслуживание, другая модель вместо неё не ответит. | Повторите, когда обслуживание закончится; ход работ — на странице статуса. |
| 503 | service_unavailable | Временный сбой на нашей стороне, например при сохранении референсного файла; /v1/responses также отвечает 503 с Retry-After, когда временно не может принять запрос. | Повторите чуть позже. |
Неудачные задачи (status — failed)
| code | Когда возникает | Что делать |
|---|---|---|
| moderation_blocked | Изображение: система безопасности поставщика модели отклонила промпт или референсное изображение (код может быть и content_policy_violation). | Перепишите промпт или замените референс; повторная отправка без изменений обычно снова отклоняется. |
| upstream_error | Любая другая ошибка: автоматические повторы не помогли, задача ждала 15 минут и так и не запустилась, поставщик отказал без объяснения причины и т. п.; что именно произошло, указано в message. | Обычно повторная отправка проходит успешно. |
Вебхуки вместо опроса
Добавьте при отправке callback_url — как только задача завершится, успешно или с ошибкой, шлюз отправит на этот URL ровно то же, что возвращает эндпоинт опроса; запрос подписан, а при неудачной доставке повторяется. Общий адрес для всего аккаунта можно также задать в консоли, в разделе «Настройки → Вебхуки». Документация по вебхукам →
curl https://kovapi.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "kling-image-4.0", "prompt": "Постер распродажи к Празднику середины осени, крупный заголовок «Полная луна — вся семья вместе» в центре, ниже «Скидка 20% на всё», тёплые золотые тона, полная луна и османтус", "size": "1:1", "callback_url": "https://your-domain.com/webhook"}'