Consultar tarea de imagen

GET /v1/tasks/{id}

Lee el estado de un trabajo de imagen. Solo hace falta si pasaste async: true; una llamada síncrona por defecto ya devuelve las imágenes. Las tareas de vídeo no se sirven aquí: usa GET /v1/video/generations/{task_id}.

Petición

bash

curl https://open.pikpikgo.com/v1/tasks/2608101909450810293847 \
  -H "Authorization: Bearer $PIKPIK_API_KEY"

Respuesta

json

{
  "id": "2608101909450810293847",
  "object": "image.generation",
  "created": 1786000185,
  "model": "img-std-1",
  "status": "succeeded",
  "prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón",
  "size": "16:9",
  "quality": "2k",
  "credits": 10,
  "error": "",
  "data": [
    { "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "una calle cyberpunk bajo la lluvia de noche, reflejos de neón" }
  ]
}

Flujo de estados

status	Significado	Qué hacer
queued	Aceptada, esperando a un worker	Seguir consultando
processing	Renderizando	Seguir consultando
succeeded	Terminada	Leer la URL en data y dejar de consultar
failed	Fallida	Leer el motivo en error y parar. Los créditos ya se devolvieron

Recomendaciones de sondeo

Cada 3 segundos para imagen (cada 5 para vídeo, en su propio endpoint). Sondear más a menudo solo consume límite y no acelera nada.
Pon un tope (por ejemplo 10 minutos para imagen y 30 para vídeo) y trátalo como tiempo agotado. Nunca un bucle infinito.
No hace falta mantener el proceso vivo: un servicio en segundo plano cierra las tareas abandonadas y devuelve los créditos de las fallidas.

Una tarea solo es visible para la cuenta que la creó. La tarea de otra persona y una inexistente devuelven exactamente el mismo 404.