Consultar y listar tareas
Obtén una tarea, lista las recientes o actualiza todas las activas; conoce el recorrido de una tarea desde la cola hasta su finalización.
Ciclo de vida de una tarea
Cada tarea pasa por estos estados:
| Estado | Significado |
|---|---|
queued | Aceptada; espera un turno de generación. |
processing | Generando; progress avanza de 0 a 100. |
completed | Terminada. Se establecen resultUrl y thumbnailUrl. |
failed | Se produjo un error; errorMessage indica el motivo. |
cancelled | La tarea se canceló antes de completarse. |
Obtén una tarea
GET /api/ai-video/jobs/{id}curl 'https://kling-4.ai/api/ai-video/jobs/0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41' \
-H 'x-api-key: YOUR_API_KEY'Devuelve { "job": … } con la misma estructura que al crear una tarea. Este endpoint actualiza la tarea desde el sistema de generación en cada llamada, por lo que debes usarlo para consultar su progreso. Un intervalo de 10–15 segundos es razonable; la generación suele tardar unos minutos.
Los identificadores desconocidos o pertenecientes a otra persona devuelven 404 JOB_NOT_FOUND.
Lista tus tareas
GET /api/ai-video/jobscurl 'https://kling-4.ai/api/ai-video/jobs' \
-H 'x-api-key: YOUR_API_KEY'Devuelve { "jobs": [...] } con tus 50 tareas más recientes, empezando por la última. Lee la base de datos sin consultar el sistema de generación, por lo que tiene poco coste, aunque puede no reflejar aún el último cambio de una tarea en proceso.
Sincroniza todas las tareas activas
POST /api/ai-video/jobs/synccurl -X POST 'https://kling-4.ai/api/ai-video/jobs/sync' \
-H 'x-api-key: YOUR_API_KEY'Actualiza todas tus tareas en cola o en proceso desde el sistema de generación en una sola llamada y devuelve la lista actualizada. Es útil al volver a abrir la aplicación tras estar sin conexión y evita consultar cada tarea por separado.
Las URL de resultado caducan
resultUrl apunta a nuestra CDN, pero el enlace tiene una duración limitada. La fecha de vencimiento figura en resultExpiresAt. Trátalo como una ventana de recogida, no como almacenamiento permanente:
if (job.status === 'completed' && job.resultUrl) {
const video = await fetch(job.resultUrl);
await fs.promises.writeFile(`out/${job.id}.mp4`, Buffer.from(await video.arrayBuffer()));
}Descarga el archivo a tu propio almacenamiento en cuanto termine la tarea. El registro de la tarea —prompt, parámetros e historial de estados— permanece en tu historial tanto si lo descargas como si no.