Skip to main content
POST
cURL
Usa este endpoint para animar una imagen de origen en un video de Kling.

Antes de llamarlo

  • Proporciona una URL pública de imagen o una cadena de imagen en base64
  • Usa una imagen que cumpla con los requisitos de píxeles de Kling; las miniaturas demasiado pequeñas son rechazadas por la tarea de generación
  • Comienza con el ejemplo predeterminado kling-v2-6, luego elige otro model_name del enum de OpenAPI cuando necesites una pista de modelo diferente
  • Mantén la primera solicitud simple: una imagen de entrada, un prompt, sin cuadro final, sin máscaras de movimiento
  • Usa dynamic_masks como un array de objetos de máscara y trayectoria cuando necesites movimiento local controlado
  • Usa sound: off para una primera solicitud determinista sin audio en las pistas de modelo que admiten sonido generado

Nomenclatura de modelos

Usa model IDs normales de modelos de video de Kling en este endpoint. Reserva los model IDs de Omni para Omni Video.

Flujo de la tarea

1

Enviar la solicitud de imagen a video

Crea la tarea y guarda el task_id de Kling devuelto.
2

Consultar la tarea

Continúa con Obtener una tarea de Kling para seguir el estado de la tarea hasta que la salida esté lista.
3

Guardar el resultado

Persistе el recurso finalizado si necesitas retención más allá de la URL de entrega del proveedor.
Para la referencia completa de parámetros, consulta el documento oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
image
string
requerido

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>
predeterminado:std

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

Opciones disponibles:
std,
pro
model_name
enum<string>
predeterminado: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.

Opciones disponibles:
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
predeterminado: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.

Opciones disponibles:
on,
off

Respuesta

200 - application/json

Task accepted.

code
integer
requerido

Error code; specifically define the error code

message
string
requerido

error message

data
object
requerido