Skip to main content
POST
cURL
Usa este endpoint para crear una tarea de texto a video de Kling a partir de un prompt. Inicia un trabajo asíncrono en lugar de devolver un video terminado de inmediato.

Primera solicitud funcional

  • Envía primero un prompt corto
  • Comienza con el ejemplo kling-v3, luego elige otro model_name del enum de OpenAPI cuando necesites una pista de modelo diferente
  • Agrega aspect_ratio, duration, mode o sound solo después de que el flujo básico funcione
  • Configura callback_url si quieres entrega push en lugar de depender únicamente del polling
  • Usa sound: off cuando quieras una primera solicitud determinista sin audio en los modelos que admiten sonido generado

Nombres de modelos

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

Duración y relación de aspecto

Este endpoint no expone un token de resolución independiente ni un campo size exacto. La relación de aspecto solicitada controla la forma del fotograma de salida.

Flujo de la tarea

1

Enviar la solicitud de generación

Crea la tarea a través de este endpoint y guarda el id de tarea de Kling devuelto.
2

Consultar el estado de la tarea

Verifica el progreso mediante Obtener una tarea de Kling hasta que la tarea alcance un estado terminal.
3

Persistir el resultado

Una vez que Kling devuelva los metadatos del recurso finalizado, mueve el resultado a tu propio almacenamiento si necesitas retención a largo plazo.
Para la matriz completa de parámetros y los detalles de las pistas de modelo, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

Content-Type
string

Must be application/json.

Cuerpo

application/json
prompt
string
requerido

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.

Opciones disponibles:
16:9,
9:16,
1:1
callback_url
string

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

model_name
enum<string>
predeterminado:kling-v1

Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.

Opciones disponibles:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

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

mode
enum<string>
predeterminado:std

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

Opciones disponibles:
std,
pro
duration
string
predeterminado:5

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

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

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

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object