Skip to main content
POST
cURL
Використовуйте цей endpoint, щоб анімувати одне вихідне зображення у відео Kling.

Перед викликом

  • Надайте одну публічну URL-адресу зображення або один рядок зображення у форматі base64
  • Використовуйте зображення, яке відповідає вимогам Kling щодо пікселів; маленькі мініатюри відхиляються завданням генерації
  • Почніть із прикладу за замовчуванням kling-v2-6, а потім виберіть інший model_name з enum в OpenAPI, коли вам потрібна інша гілка моделі
  • Зробіть перший запит простим: одне вхідне зображення, один prompt, без кінцевого кадру, без масок руху
  • Використовуйте dynamic_masks як масив об’єктів маски та траєкторії, коли вам потрібен контрольований локальний рух
  • Використовуйте sound: off для детермінованого першого запиту без аудіо на гілках моделі, які підтримують згенерований звук

Найменування моделей

Використовуйте звичайні model ID відеомоделей Kling у цьому endpoint. Залишайте model ID Omni для Omni Video.

Потік завдання

1

Надішліть запит image-to-video

Створіть завдання та збережіть повернутий Kling task_id.
2

Опитуйте завдання

Продовжуйте з Отримати завдання Kling, щоб відстежувати статус завдання, доки результат не буде готовий.
3

Збережіть результат

Збережіть готовий asset, якщо вам потрібне зберігання довше, ніж URL доставки від провайдера.
Щоб переглянути повний довідник параметрів, дивіться офіційний документ Kling.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json
image
string
обов'язково

Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value.

prompt
string

Text prompt describing the desired motion. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

callback_url
string

Webhook URL to receive task status updates when the task completes.

mode
enum<string>
за замовчуванням:std

Generation mode. std for standard (faster), pro for professional (higher quality).

Доступні опції:
std,
pro
model_name
enum<string>
за замовчуванням:kling-v1

Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.

Доступні опції:
kling-v1,
kling-v1-5,
kling-v1-6,
kling-v2-master,
kling-v2-1,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
image_tail
string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

duration
string
за замовчуванням:5

Output video length in seconds. Use 5 or 10; omit to use 5.

static_mask
string

Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.

dynamic_masks
object[]

Optional motion masks. Each entry contains a mask image and an ordered trajectory list.

external_task_id
string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Доступні опції:
on,
off

Відповідь

200 - application/json

Task accepted.

code
integer
обов'язково

Error code; specifically define the error code

message
string
обов'язково

error message

data
object
обов'язково