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

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

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

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

string
обязательно
Укажите kling-v4-image.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Обязателен для генерации по тексту, по изображению и для серий. Можно описать как желаемое, так и нежелательное содержимое. Ограничение — 50 000 символов для текста только на английском и 21 000 для текста только на китайском и подобных языках; для смешанного текста лимит рассчитывается пропорционально.
string[]
До 10 референсов в виде общедоступных прямых URL изображений. Локальные файлы можно загрузить через API загрузки изображений, затем передать полученный url.Поддерживаются JPG / JPEG / PNG / GIF. Каждое изображение: не более 30 MB, ширина и высота не менее 300 px, соотношение сторон от 2:5 до 5:2.Референсы проверяются при отправке. Ответ URL HTTP 403 / 404 / 410, любая сторона менее 300 px, пропорции вне диапазона 2:5–5:2 или размер более 30 MB сразу приводят к HTTP 400: задача не создаётся, плата за генерацию не взимается. Другие ошибки загрузки, например тайм-аут исходного сервера, сначала принимаются; затем задача завершается ошибкой, а предварительно списанная плата за генерацию возвращается полностью.В промпте можно использовать @Image1, @Image2 и т. д. по порядку изображений в массиве. Без этих меток изображения также учитываются как референсы.
integer
по умолчанию:"1"
Число результатов в обычном режиме: целое от 1 до 9, по умолчанию 1. В режиме серии можно не передавать n или указать 1; число результатов задаёт sequential_image_generation_options.max_images. Значение n > 1 в серии приводит к HTTP 400.
string
по умолчанию:"2K"
Поддерживаются 2K (по умолчанию), 4K и 8K без учёта регистра. Формат результата — PNG. При 1:1 размер 2K — 2048×2048, 4K — 4096×4096, 8K — 8192×8192. Для других пропорций ориентируйтесь на фактические размеры полученных изображений.В 8K доступны генерация по тексту, по изображениям и создание серий: 1–9 результатов в обычном режиме, 2–4 в серии и до 10 референсов. Требования к формату, размерам и ограничение 30 MB на каждый референс не меняются.
string
по умолчанию:"auto"
Соотношение сторон результата. Поддерживаются auto (по умолчанию) и следующие 8 значений:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto выбирает пропорции по промпту или референсам. Размеры в пикселях, например 2048x2048, не поддерживаются.
string
Псевдоним size с теми же значениями. Если переданы оба поля, приоритет имеет aspect_ratio.
string
по умолчанию:"disabled"
disabled или отсутствие поля означает обычную генерацию. auto включает серию связанных изображений и требует sequential_image_generation_options.max_images. Здесь auto не означает автоматический выбор числа изображений.
object
Задаёт количество изображений в режиме серии.
width, height, mask_url, размер size в пикселях и watermark: true не поддерживаются и приводят к HTTP 400.

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

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

Генерация по изображению

Создать три изображения 4K

Создать одно изображение 8K

Создать серию из четырёх связанных изображений 8K

Укажите max_images от 2 до 4. В серии n можно не передавать или задать 1, но значение не может превышать 1. Создание серии может занять несколько минут; сохраните task_id и проверяйте состояние, не отправляя повторный запрос.

Примеры результатов 8K и времени обработки

Ниже приведены замеры в тестовой среде. Размеры изображений и файлов, а также время обработки указаны для примера; фактические результаты могут отличаться. Проверяйте статус каждые 5–10 секунд до completed или failed. Значение estimated_time всегда равно 60 секундам и не подходит для прогноза завершения или обратного отсчёта. Сохраните task_id и не отправляйте повторный запрос во время ожидания. Результаты 8K — оригинальные PNG, и один файл может превышать 100 MB. Для списков и предпросмотра используйте самостоятельно созданные миниатюры или загрузку по требованию. Предусмотрите скачивание оригинала и укажите большой размер файла.

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

Читайте data.status через API проверки задач: pending / processing — обработка, completed — успех, failed — ошибка с описанием в data.error.message.
Ниже показана структура успешного результата. URL находятся в data.result.images[].url[]; url является массивом. Переберите все результаты и своевременно скачайте их.

Оплата

Стоимость зависит от фактического количества созданных изображений и выбранного разрешения. Референсы оплачиваются отдельно за каждое изображение. Тарифы приведены на странице цен.
  • В обычном режиме n=3 оплачивается как 3 результата; для серии учитывается фактически возвращённое количество.
  • Каждый референс учитывается один раз за запрос, без умножения на число результатов. При создании 3 изображений по 2 референсам оплачиваются 2 входа и 3 результата.
  • Неудачные задачи генерации не оплачиваются; предварительно списанная плата за генерацию возвращается полностью.

Частые ошибки параметров

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