Consultar tarefa de imagem

GET /v1/tasks/{id}

Lê o estado de um trabalho de imagem. Só é preciso se passaste async: true; uma chamada síncrona por predefinição já devolve as imagens. As tarefas de vídeo não são servidas aqui: usa GET /v1/video/generations/{task_id}.

Pedido

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

Resposta

{
  "id": "2608101909450810293847",
  "object": "image.generation",
  "created": 1786000185,
  "model": "img-std-1",
  "status": "succeeded",
  "prompt": "uma rua cyberpunk à chuva de noite, reflexos de néon",
  "size": "16:9",
  "quality": "2k",
  "credits": 10,
  "error": "",
  "data": [
    { "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "uma rua cyberpunk à chuva de noite, reflexos de néon" }
  ]
}

Fluxo de estados

Recomendações de sondagem

• De 3 em 3 segundos para imagem (de 5 em 5 para vídeo, no seu próprio endpoint). Sondar mais depressa só consome limite de chamadas e não acelera nada.
• Define um teto (por exemplo 10 minutos para imagem e 30 para vídeo) e trata-o como tempo esgotado. Nunca um ciclo infinito.
• Não é preciso manter o processo vivo: um serviço em segundo plano encerra as tarefas abandonadas e devolve os créditos das falhadas.