Kling 3.0 Turbo

Genera con Kling 3.0 Turbo clips de 3 a 15 segundos con sonido a partir de un prompt o de un primer fotograma, en 720p o 1080p, facturados por segundo y entregados como tarea.

Kling 3.0 Turbo es un modelo de vídeo de la familia Kling 3.0 de Kuaishou. Una sola solicitud crea un clip de 3 a 15 segundos con sonido a partir de un prompt, o de un prompt más un primer fotograma, en 720p o 1080p. Envía la solicitud, guarda el identificador de tarea devuelto y lee el vídeo terminado desde la tarea. Las imágenes se envían como URL.

ID de modelo

ID de modelo	Entradas	Resoluciones	Duración
`kling-3-0-turbo`	texto, primer fotograma	`720p`, `1080p`	De 3 a 15 segundos

Consulta la página del modelo para ver los precios actuales.

Ejemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Encabezado	Valor
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no el vídeo terminado. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del lado del servidor.

Parámetros

Campo	Tipo	Por defecto	Notas
`model`	string	obligatorio	`kling-3-0-turbo`
`prompt`	string	obligatorio	Hasta 3072 caracteres, o 2500 con un primer fotograma. También obligatorio con un primer fotograma.
`first_frame_image`	URL	ninguno	El primer fotograma del clip. Sin él, el clip es de texto a vídeo.
`resolution`	enum	`720p`	`720p` o `1080p`.
`duration`	integer	`5`	De 3 a 15 segundos.
`aspect_ratio`	enum	`16:9`	`16:9`, `9:16` o `1:1`. Solo texto a vídeo: con un primer fotograma, el fotograma define la forma.
`watermark`	boolean	ninguno	`true` añade una marca de agua. Si se omite, el clip no lleva ninguna.

Todos los clips llevan sonido; no hay ningún ajuste de sonido. El esquema es estricto: los campos desconocidos se rechazan en lugar de ignorarse. callback_url no está disponible; consulta la tarea en su lugar.

Imagen a vídeo

Pasa un primer fotograma en first_frame_image y describe lo que ocurre después en prompt. El clip empieza con ese fotograma y toma su forma, así que aspect_ratio no se usa.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

Entradas multimedia

El primer fotograma es una URL HTTP(S) pública. No se aceptan data URI en base64: sube el archivo a tu propio almacenamiento y pasa su URL. Usa una imagen JPG o PNG de 10 MB o menos.

Factores de coste

Consulta la sección de precios del modelo para ver las tarifas actuales. Kling 3.0 Turbo se factura por segundo de vídeo, con una tarifa que fija la resolución:

cost = duration × rate per second for the resolution

La duración se conoce cuando se acepta la solicitud, así que el importe reservado es el importe cobrado. Consulta los cargos definitivos en el historial de uso de tu cuenta. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

{"id": "task_...", "model": "kling-3-0-turbo", "status": "processing", "created_at": 1789689600}

Consultar la tarea

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Sondea cada 10–20 segundos hasta que status sea completed o failed. Que se agote el tiempo de red durante el sondeo no significa que la generación haya fallado: conserva el identificador de tarea y reanuda la comprobación. No crees otra tarea para consultar el progreso.

Tarea completada

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

En nuestras pruebas, los clips 720p de 3 segundos llegaron como MP4 (H.264) a 1280 × 720 y los clips 1080p de 5 segundos a 1920 × 1080, todos con una pista de audio estéreo, entre 54 segundos y unos 5 minutos 20 segundos después del envío.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo de errores común para ver códigos, estados HTTP y pautas de reintento.

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si el propio envío agota el tiempo de espera, revisa tus tareas antes de volver a enviar: puede que la primera solicitud se haya aceptado.

Consejos

Describe el sujeto, el lugar, el movimiento de cámara y la luz con una frase cada uno; el modelo sigue el lenguaje de cámara, como «lento acercamiento» y «contrapicado».
Haz el borrador en 720p y luego renderiza la toma final en 1080p con la misma solicitud.
Con un primer fotograma, describe solo lo que se mueve: el fotograma ya define la escena.
Añade no text, no logos para evitar marcas inventadas.