Перейти к основному содержанию
POST
Отправьте асинхронный запрос в POST /v1/images/generations с model: "kling-v4-long-image". Получите data[0].task_id, затем проверьте GET /v1/tasks/{task_id}. Каждый запрос возвращает один длинный PNG; режим веб-страницы создаёт изображение её дизайна.

Выбор режима

Аутентификация

string
обязательно
Используйте Authorization: Bearer <token>, где <token> — ваш API-ключ APIMart.

Параметры запроса

string
обязательно
Укажите kling-v4-long-image.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Обязателен, не может состоять только из пробелов. До 166 000 символов для текста только на английском, до 71 000 для китайского и подобных языков; смешанный текст рассчитывается пропорционально. Опишите макет, разделы, тексты, стиль и объект.
string
обязательно
Обязателен: ecommerce для страницы товара или webpage для дизайна веб-страницы, без учёта регистра. Режимы используют разные поля референсов.
string
по умолчанию:"medium"
Только для skill: "ecommerce": short, medium (по умолчанию) или long, примерно 2–5, 6–10 или 11–18 разделов. Фактическое содержание и высота зависят от результата. В режиме веб-страницы поле нужно опустить, иначе HTTP 400.
string
по умолчанию:"1K"
Поддерживаются 1K (по умолчанию) и 2K без учёта регистра. Для товара оба разрешения доступны при любой длине, включая long + 2K. Ширина результата — 1024 и 2048 px соответственно, высота зависит от содержания. 4K не поддерживается.
string[]
Только для страницы товара: обязательны 1–3 изображения. В режиме веб-страницы опустите поле и используйте image_with_roles. Нужны общедоступные прямые URL. Локальные файлы можно загрузить через API загрузки изображений и передать полученный url.
object[]
Необязательно, только для веб-страниц. Не более одного изображения style и одного subject; можно опустить одну или обе роли. В режиме товара поле нужно опустить.
integer
Каждый запрос создаёт одно длинное изображение. Опустите поле или передайте целое 1; другие значения приводят к HTTP 400.
boolean
Опустите поле или передайте false; true приводит к HTTP 400.
Не передавайте size, aspect_ratio, width, height, mask_url, sequential_image_generation и sequential_image_generation_options. Даже null или пустая строка в этих полях приводит к HTTP 400.

Требования к референсам и их обозначения

Поддерживаются JPG / JPEG / PNG. Каждый файл — до 30 MB, обе стороны не менее 300 px, пропорции от 2:5 до 5:2. Ответ URL HTTP 403 / 404 / 410, неподходящие размеры или пропорции, превышение размера файла синхронно возвращают HTTP 400 без создания задачи и платы за генерацию. Другие ошибки загрузки, например тайм-аут исходного сервера, сначала принимаются; затем задача завершается ошибкой с возвратом предоплаты. Используйте в промпте @Image1, @Image2 и т. д. Для товаров порядок соответствует image_urls; для веб-страницы сначала идёт стиль, затем объект. Если передана одна роль, её изображение — @Image1.

Примеры запросов

Отправляйте запросы в POST /v1/images/generations. Замените примерные URL доступными прямыми ссылками.

Длинная страница товара в 2K

Веб-страница с референсами стиля и объекта

Веб-страница только по промпту

Проверка задачи

Опрос API задач рекомендуется выполнять раз в 10 секунд. Сохраните task_id и не дублируйте запрос генерации при долгом ожидании.
Ниже показана структура успешного результата. images и url — массивы; модель возвращает одно длинное изображение за запрос.
Скачайте изображение до Unix-времени в секундах из data.result.images[0].expires_at. После этого ссылка истекает.
Генерация обычно занимает несколько минут; один пример long + 2K потребовал 432 секунды. estimated_time сейчас всегда равен 60 секундам и не подходит для обратного отсчёта или порога тайм-аута. Время зависит от содержания и нагрузки; замер не является верхним пределом.Высота и размер файла зависят от содержания. Один пример long + 2K имел 2048×46615 пикселей и 63,9 MB; это не ограничения вывода. Результат может превышать 50 MB — учитывайте затраты на загрузку и отображение больших изображений.

Оплата

За запрос оплачивается одно длинное изображение по выбранному тарифу плюс референсы: цена выходного тарифа + число референсов × цена референса. Учитываются товар, стиль и объект; первый референс также платный. Ниже перечислены 8 выходных тарифов. Ключи цен: kling-v4-long-image@<тариф> и kling-v4-long-image@input для референсов. В запросе генерации resolution по-прежнему принимает только 1K или 2K. При отправке сумма списывается предварительно, при успехе расчёт завершается, при ошибке предоплата возвращается полностью. Цены и скидки аккаунта указаны на странице цен.

Частые ошибки

Эти ошибки проверки синхронно возвращают HTTP 400 без создания задачи и платы за генерацию. Ошибки отправки — в error.message, ошибки после создания — в data.error.message.