APIMaster.ai

Kling Image 4.0 · API изображений

Kling Image 4.0 создаёт отдельные изображения, согласованные серии, карточки товаров и длинные макеты страниц.

Kling Image 4.0

Kling Image 4.0 создаёт отдельные изображения, согласованные серии, карточки товаров и длинные макеты страниц.

Эндпоинты

  • POST https://apimaster.ai/v1/kling/kling-image-4.0/image-generation · single, series
  • POST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation · ecommerce, webpage
  • GET https://apimaster.ai/v1/kling/kling-image-4.0/tasks/{task_id}

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

Поле Значение
contents JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image.
contents[].text Укажите один непустой промпт. Используйте @id для ссылок на конкретные материалы.
contents[].id Уникальный идентификатор каждой ссылки в запросе.
contents[].url Публичный URL изображения или Base64. JPG, JPEG и PNG до 30 МБ, обе стороны не менее 300 пикселей, пропорции от 2:5 до 5:2.
contents[].element_id Идентификатор элемента изображения из вашего аккаунта или поддерживаемого пресета. Считается одной ссылкой.
settings.result_type single, series. По умолчанию single.
settings.n single → 1–9. По умолчанию 1.
settings.series_amount series → 2–10 / auto (2–10). По умолчанию 4.
settings.resolution single / series → 2k, 4k, 8k. По умолчанию 2k. ecommerce / webpage → 1k, 2k. По умолчанию 1k.
settings.aspect_ratio single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. По умолчанию auto.
settings.skill long-image-generation → ecommerce, webpage.
settings.length ecommerce → short, medium, long. По умолчанию medium.
options.watermark_info.enabled boolean. По умолчанию false. true → outputs[].watermark_url.
options.callback_url Необязательный URL вебхука, зарегистрированный и подтверждённый в аккаунте APIMaster.
options.external_task_id Необязательный идентификатор корреляции до 128 байт, возвращаемый с задачей.

Для обычных изображений и серий доступно до 10 ссылок и элементов суммарно. Карточка требует 1–3 refer_image. Веб-страница принимает по одному образцу стиля и объекта.

Обычный промпт — 50 000 английских или 21 000 неанглийских символов. Длинный — 166 000 или 71 000. Для смешанного текста сумма долей от лимитов должна быть не больше 1.

Одиночный режим создаёт независимые изображения. Серия возвращает связанные изображения по порядку с общим group_id. Результат длинной генерации — одно изображение. length применяется к карточкам товаров и задаёт примерно 2–5, 6–10 или 11–18 секций.

Примеры

single

curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/image-generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling-image-example-001" \
  -d '{"contents":[{"type":"prompt","text":"A blue ceramic cup in soft daylight"}],"settings":{"resolution":"2k","aspect_ratio":"1:1"}}'

series

{
  "contents": [
    {
      "type": "prompt",
      "text": "Create two coordinated studio photographs of the blue ceramic cup in @cup. Show a front view and a detail close-up."
    },
    {
      "type": "refer_image",
      "id": "cup",
      "url": "https://example.com/cup.png"
    }
  ],
  "settings": {
    "result_type": "series",
    "series_amount": 2,
    "resolution": "4k",
    "aspect_ratio": "3:4"
  },
  "options": {
    "watermark_info": {
      "enabled": true
    },
    "external_task_id": "campaign-cup-001"
  }
}

ecommerce

{
  "contents": [
    {
      "type": "prompt",
      "text": "Design a product detail page for @cup. Include a hero image, material details, and care instructions."
    },
    {
      "type": "refer_image",
      "id": "cup",
      "url": "https://example.com/cup.png"
    }
  ],
  "settings": {
    "skill": "ecommerce",
    "length": "short",
    "resolution": "1k"
  }
}

webpage

{
  "contents": [
    {
      "type": "prompt",
      "text": "Design a long product landing page for a ceramic cup collection."
    }
  ],
  "settings": {
    "skill": "webpage",
    "resolution": "2k"
  }
}

Результаты задачи

Сохраните task_id и проверяйте с того же аккаунта. При успехе outputs содержит URL каждого изображения и необязательные watermark_url и group_id. При ошибке читайте error.

curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "task_id": "task_example",
  "object": "image",
  "model": "kling-image-4.0",
  "status": "completed",
  "outputs": [{"type": "image", "url": "https://example.com/generated.png"}]
}

При повторе используйте прежний Idempotency-Key. После тайм-аута проверьте исходную задачу.

Оплата

Стоимость складывается из цены доставленных изображений и входных референсов. Актуальные цены указаны в каталоге. Kling Image 4.0