Integración de API de Kling 2.6
Usa Kling 2.6 mediante Rivya Public API v1 con el model id kling-2-6, entradas compatibles, parámetros, reglas de Files API, créditos y ejemplos de respuesta.
kling-2-6
text, file
Requerido para modos con referencia
55
Video
FIXED
1000 caracteres
Contrato de solicitud
Envía el ID de modelo en el nivel superior. Los controles específicos del modelo van en params.
| Key | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| model | string | Sí | kling-2-6 | Usa kling-2-6 como ID de modelo de API. |
| prompt | string | Sí | - | Máximo de 1000 caracteres para este modelo. |
| params | object | No | - | Objeto de parámetros específico del modelo. Usa las filas siguientes para ver las keys permitidas. |
| client_request_id | string | No | - | ID opcional del cliente para rastrear solicitudes en tu sistema. |
Parámetros del modelo
| Key | Tipo | Obligatorio | Predeterminado | Rango | Opciones | Descripción |
|---|---|---|---|---|---|---|
| duration | select | No | 5 | - | 5, 10 | Duración |
| sound | select | No | false | - | false, true | Generar audio |
| aspect_ratio | select | No | 1:1 | - | 1:1, 16:9, 9:16 | Relación de aspecto |
Política de subida
Primero sube los archivos de referencia; después coloca la URL devuelta y el durationToken dentro de params.referenceMediaItems.
Imagen de referencia: Sube hasta 1 archivo de imagen para proyectos de imagen.
1
image
Las referencias de video y audio deben incluir durationToken de /api/v1/files cuando se requiera verificar la duración.
| kind | Tamaño máximo | Tipos MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Solicitud mínima
{
"model": "kling-2-6",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "5",
"sound": "false",
"aspect_ratio": "1:1"
}
}Solicitud con archivo de referencia
{
"model": "kling-2-6",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"duration": "5",
"sound": "false",
"aspect_ratio": "1:1",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Respuesta de creación
El endpoint de creación devuelve un ID de tarea público. Consulta el endpoint de estado hasta que la tarea termine correctamente o falle.
{
"id": "task_kling_2_6_example",
"status": "queued",
"model": "kling-2-6",
"reserved_credits": 55,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Errores comunes
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Algunos modos requieren subidas de referencia mediante Files API.