Documentação da APIJobs e espera limitada
Consultar trabalho assíncrono e ler resultados higienizados
Operações de imagem são jobs duráveis. A primeira resposta traz o objeto de job
público completo e Location: /api/v1/jobs/{job_id}.
Ler um job
curl https://sci-draw.com/api/v1/jobs/job_012345 \
-H 'Authorization: Bearer sd_YOUR_KEY'Escopo necessário: jobs:read. Os jobs são lidos por ID e por propriedade da
conta. Um job inexistente e um job de outra conta retornam ambos
404 JOB_NOT_FOUND.
Ciclo de status
| Status | Significado |
|---|---|
queued | aceito e aguardando execução |
processing | em andamento |
succeeded | result.files está disponível |
failed | error traz um código público estável e uma mensagem |
canceled | o job não será executado |
Status terminais nunca voltam a mudar. Consulte jobs não terminais usando o valor
Retry-After retornado pelas requisições de criação; a recomendação atual é dois
segundos.
Espera limitada
Os endpoints de criação aceitam Prefer: wait=N, em que N é um inteiro de 1 a
30. Se o job chegar a um estado terminal dentro da janela, o endpoint retorna
200. Se ainda estiver rodando no prazo, retorna o job atual com 202. Serve
para clientes interativos, mas integrações de servidor devem sempre guardar o ID
do job e estar prontas para fazer polling.
Resultado bem-sucedido
{
"success": true,
"data": {
"id": "job_012345",
"object": "image_job",
"type": "image_generation",
"status": "succeeded",
"created_at": "2026-08-07T12:00:00.000Z",
"completed_at": "2026-08-07T12:00:41.000Z",
"credits_reserved":
Nenhuma resposta de job contém os prompts enviados, referências às imagens de origem, identificadores internos, detalhes de execução ou diagnósticos privados.