GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Todas las guías

· reAPI Team

Estado de tareas de Kie AI: ¿atascada al 99 % o aún procesándose?

Lee el estado de una tarea de Kie AI si la generación sigue al 99 %. Revisa tarea original, resultado, callback y créditos antes de decidir si envías otra.

Estado de tareas de Kie AI: ¿atascada al 99 % o aún procesándose?

La barra de progreso ha llegado al 99 %. El vídeo sigue sin aparecer. Antes de volver a pulsar Generar, busca el ID de tarea del primer intento: así sabrás si esperas un vídeo o si esperas a que tu aplicación detecte un vídeo que ya existe.

El estado de una tarea de Kie AI procede de su registro. Para los trabajos de Market, ese registro distingue espera, generación, éxito y fallo, y contiene el resultado o error junto al estado.[1] Un porcentaje por sí solo no puede decidir por ti el siguiente paso. Empieza por la tarea existente y sigue la rama que su respuesta realmente justifique.

Busca la tarea que originó la barra de progreso

Abre la respuesta de tu envío original. Si usaste la API Market de Kie, busca el taskId devuelto. La consulta es GET /api/v1/jobs/recordInfo?taskId=...; recupera trabajos creados con POST /api/v1/jobs/createTask. Otras familias de endpoints necesitan su propia documentación. Una petición de chat síncrona, por ejemplo, no produce una tarea de Market que consultar periódicamente.[2][1]

Si usas el sitio web, el área Logs de Kie es el lugar documentado para encontrar tareas enviadas, sus parámetros y resultados.[3] En una automatización, examina la salida del nodo de envío. Copia el ID de ahí y no de un reintento posterior: dos envíos con el mismo prompt siguen siendo dos intentos que debes rastrear.

En tu propia aplicación, guarda el ID del proveedor junto a la referencia del trabajo del cliente. Imagina una publicación programada llamada friday-demo con el vídeo aún pendiente. El nombre de la programación te dice para qué es el vídeo; el ID del proveedor te dice qué generación recuperar. Es una estructura de registro sugerida, no una función de Kie. Conservar ambos permite reiniciar tu worker sin reiniciar el trabajo creativo.

¿No hay ningún ID de tarea? Vuelve a los registros de envío antes de cambiar el prompt. Una respuesta perdida deja sin resolver el primer envío. Debes determinar si se aceptó, mediante el historial de cuenta disponible o soporte, antes de tratar un segundo envío como un reintento inofensivo.

Lee la respuesta antes de cambiar el flujo de trabajo

Hay dos comprobaciones antes de llegar al estado de la tarea. Primero examina la respuesta HTTP. Después examina el code del JSON. La referencia de tareas de Kie documenta errores de negocio dentro de respuestas HTTP 200, incluidas credenciales no válidas e IDs de tarea ausentes, inexistentes o de otro propietario. También enumera respuestas de error HTTP. Gestionar solo una de esas formas deja un hueco.[1]

Esto importa cuando un flujo parece atascado. Si tu sistema de sondeo sigue recibiendo un error de consulta pero la pantalla sigue mostrando el último valor de progreso, mirar el porcentaje un minuto más no te dirá qué hace la tarea. Compara el ID y la cuenta con el envío original. Guarda el cuerpo del error sin la clave API. Corrige la consulta antes de diagnosticar la generación.

Cuando la consulta tenga éxito, lee data.state:

  • waiting y queuing significan que la tarea espera en una cola.
  • generating significa que el procesamiento está en curso.
  • success significa que puedes examinar el resultado devuelto.
  • fail significa que debes examinar failCode y failMsg.

Esos son los estados documentados de la API Market.[1] Un valor desconocido merece su propio tratamiento en tu cliente; tratarlo silenciosamente como un fallo convertiría una respuesta que no entiendes en un motivo para generar otra vez.

El siguiente decodificador separa esos casos. Opera sobre una respuesta que tu servidor ya ha obtenido. No incluye ningún envío ni reintento automático.

function inspectMarketTask(httpStatus, body) {
  if (httpStatus < 200 || httpStatus >= 300) {
    return { kind: 'lookup_error', httpStatus };
  }
  if (body?.code !== 200 || !body.data) {
    return { kind: 'lookup_error', code: body?.code, message: body?.msg };
  }

  const task = body.data;
  if (['waiting', 'queuing', 'generating'].includes(task.state)) {
    return { kind: 'pending', taskId: task.taskId, state: task.state };
  }
  if (task.state === 'fail') {
    return {
      kind: 'failed', taskId: task.taskId,
      code: task.failCode, message: task.failMsg,
      credits: task.creditsConsumed,
    };
  }
  if (task.state !== 'success') {
    return { kind: 'unknown_state', taskId: task.taskId, state: task.state };
  }

  let result;
  try { result = JSON.parse(task.resultJson); }
  catch { return { kind: 'result_unreadable', taskId: task.taskId }; }
  const urls = result?.resultUrls;
  if (!Array.isArray(urls) || !urls.length ||
      urls.some(url => typeof url !== 'string' || !url.trim())) {
    return { kind: 'output_missing', taskId: task.taskId };
  }
  return { kind: 'ready', taskId: task.taskId, urls };
}

Las etiquetas kind pertenecen a este ejemplo. La comprobación de salida cubre los trabajos multimedia cuyo resultJson analizado contiene resultUrls; no cubre la salida de todos los modelos. Los modelos de texto y detección de sujetos tienen estructuras diferentes.[1] Incluso ready solo indica que están presentes las cadenas de URL esperadas. Aún queda descargar y comprobar el archivo real.

Si tuvo éxito, sigue el recorrido del archivo

Para un trabajo multimedia exitoso, analiza resultJson como JSON y busca las URL esperadas. El campo es una cadena JSON, por lo que leer task.resultJson.resultUrls como si ya fuera un objeto no recuperará el array descrito en la documentación.[1]

Después avanza a partir de la respuesta. ¿Contiene el campo multimedia esperado? ¿Puede tu servidor descargar desde esa URL? ¿Guardó los bytes el paso de almacenamiento? ¿Apunta la página al archivo guardado? Cada respuesta acota dónde reanudar. Un fallo al subir a tu almacenamiento justifica repetir esa subida mientras el archivo de origen siga disponible, no comprar otra generación.

Por ejemplo, supón que tus registros muestran una tarea exitosa seguida de una subida fallida al archivo. Es un caso hipotético de depuración. Mantén el ID de la tarea exitosa vinculado al trabajo, recupera su resultado si hace falta y reinicia el paso de archivado. Si ejecutas el flujo desde su primer nodo, habrás enviado otra vez la misma petición creativa a generación sin resolver el fallo de almacenamiento.

Guarda pronto las salidas útiles. La página de inicio de Kie indica un periodo de conservación multimedia de 14 días, pero la referencia Market describe una validez de URL de una hora para OmniHuman 1.5 Subject Detection. La excepción específica del modelo importa.[3][1] Un registro de tarea exitosa y un archivo descargable permanentemente son cosas distintas. Conserva juntos el archivo descargado, el ID original y la respuesta para que una URL que falte más adelante no borre tu registro de lo ocurrido.

Si aún se está generando, deja que termine la misma tarea

La guía de Kie recomienda callbacks en producción y espera exponencial entre consultas, empezando con intervalos de dos a tres segundos. También dice que algunas tareas de vídeo tardan más de diez minutos.[1] Eso basta para rechazar una regla universal de «diez minutos significa fallo». No promete que todas las tareas retrasadas acaben teniendo éxito.

Tu aplicación puede dejar de esperar antes de que la tarea deje de ejecutarse. Una publicación programada tiene un plazo; una sesión de navegador debe considerar la paciencia del usuario. Decide qué ocurre cuando vence tu propio límite de espera. Un resultado local útil es «requiere atención», conservando el ID de tarea para consultarlo después. Llamarlo «fallido» sin una respuesta terminal hace que el siguiente operador crea que la generación ha terminado cuando solo has dejado de observarla.

Si configuraste callBackUrl, comprueba también la ruta del callback. Kie admite notificaciones para tareas exitosas y fallidas. Su esquema de verificación firma el ID de tarea y la marca de tiempo en lugar del cuerpo completo de la respuesta, y su guía remite a la consulta autenticada de tareas para obtener el resultado autorizado.[4]

Usa la notificación para activar el trabajo existente. Recupera su estado y ejecuta el mismo tratamiento de finalización que usarías después del sondeo. Si una consulta ya recuperó el vídeo, un callback posterior debe encontrar ese trabajo local completado. Diseña ese controlador para que no pueda publicar de nuevo la misma entrada simplemente porque la finalización llegó por otra ruta.

En n8n, reinicia desde el paso que necesita trabajo

El ajuste que debes examinar es Retry on Fail del nodo HTTP Request. n8n documenta que reintenta el nodo que falló.[5] Lee la operación dentro de ese nodo antes de activarlo.

Un nodo que consulta una tarea conocida puede repetir la consulta. Un nodo que envía el POST de generación repite un envío. Esas operaciones no deben compartir una decisión de reintento solo porque ambas usan HTTP. Si un flujo mayor agrupa envío, espera y descarga en un paso reiniciable, separa el ID de tarea guardado para que la recuperación pueda entrar después del envío.

Para el fallo hipotético de archivado anterior, el punto de reanudación es el nodo de descarga o almacenamiento. Para un callback perdido, es la consulta. Para state: fail, lee primero el fallo y decide si se justifica cambiar la petición. Para un envío de resultado desconocido, detén la repetición automática mientras concilias el primer intento.

La guía del flujo diario de vídeo muestra un enfoque de trabajos persistentes en reAPI. Sus campos API difieren de los de Kie, pero la decisión de diseño útil es la misma: conservar suficiente estado para continuar el trabajo inacabado sin repetir el terminado.

Si falló, conserva el error junto al cargo

Kie dice que las tareas fallidas no se cobran. La respuesta de tarea también expone creditsConsumed, junto al estado, los campos de error y las marcas de tiempo.[3][1] Compara esos registros para ese intento concreto. Un cambio en tu saldo global no puede identificar qué ocurrió con un vídeo si había varios trabajos más en marcha.

Si ya volviste a pulsar Generar, conserva ambos IDs en la investigación. La primera tarea podría ser la representada por la barra de progreso, mientras que la segunda es aquella cuyo cargo estás mirando. Asocia cada respuesta a su propio envío antes de pedir una corrección de facturación.

Para soporte, indica primero el ID de tarea y el modelo, seguidos de la hora de envío y zona horaria, última respuesta, mensaje de error y movimiento de créditos relevante. Di dónde se detuvo el trabajo: sin estado terminal, resultado exitoso sin URL utilizable, descarga fallida o aparente discrepancia de facturación. La página de inicio de Kie dirige las preguntas técnicas a sus grupos de soporte.[3] Elimina credenciales y entradas privadas no relacionadas de todo lo que compartas.

La política de tareas fallidas no permite a este artículo prometer un reembolso para una cuenta individual. Te da una discrepancia concreta que pedir a soporte que resuelva. Si la tarea tuvo éxito pero el vídeo no cumplió tus indicaciones, descríbelo por separado; una queja de calidad y un fallo de generación registrado son cuestiones de soporte distintas.

Llévate la lógica de recuperación si cambias de API

Si el trabajo recurrente de recuperación te lleva a evaluar reAPI, empieza por la respuesta de tarea. Los trabajos multimedia ordinarios usan processing, completed y failed; los resultados están bajo output, y usage.credits informa del consumo liquidado. Consultar periódicamente una tarea conocida no consume créditos.[6] Asocia explícitamente esos campos en lugar de reutilizar sin cambios un decodificador de respuestas de Kie.

Hay límites que debes tener en cuenta. Los callbacks de reAPI no están firmados, así que verifica una tarea pendiente conocida mediante una consulta autenticada; la información de entrega está disponible con ?include=webhook.[7] Repetir un POST de generación con Idempotency-Key no lo deduplica, y algunos fallos de seguridad posteriores a la generación, específicos del modelo, conservan el cargo.[8][6] Mantén las comprobaciones de intentos guardados y liquidación cuando migres.

Usa el catálogo de modelos para comprobar el modelo que necesitas y la comparativa de Kie para la cuestión más amplia de la elección. Ni cambiar de plataforma ni un segundo POST resuelve el vídeo que ya está al 99 %. Para ese vídeo, vuelve a su ID de tarea y reanuda desde el último paso cuyo resultado puedas determinar.

Referencias

  1. Kie AI. Obtener detalles de tareas, API Market. Consultado el 15 de noviembre de 2026.
  2. Kie AI. Inicio rápido de Market y estructura unificada de la API. Consultado el 15 de noviembre de 2026.
  3. Kie AI. Preguntas frecuentes de la página de inicio: tareas, soporte, conservación y créditos de prueba. Consultado el 15 de noviembre de 2026.
  4. Kie AI. Verificación de seguridad de webhooks. Consultado el 15 de noviembre de 2026.
  5. n8n. Problemas comunes del nodo HTTP Request: Retry on Fail. Consultado el 15 de noviembre de 2026. Solución de problemas de HTTP Request.
  6. reAPI. Tareas. Revisado el 15 de noviembre de 2026. Documentación de sondeo de tareas.
  7. reAPI. Webhooks. Revisado el 15 de noviembre de 2026. Contrato de entrega y verificación.
  8. reAPI. Resumen de la API. Revisado el 15 de noviembre de 2026. Documentación de envío e idempotencia.
Todas las guías