Consultar job

GET/v2/jobs/:jobId

Gratis · sin scope

curl https://api.beta.pictulab.com/v2/jobs/6f1c2a7e-… \
  -H "Authorization: Bearer $PICTULAB_API_KEY"

Respuesta

{
  "id": "6f1c2a7e-…",
  "type": "image_generation",
  "status": "completed",
  "params": { "prompt": "…", "model_id": "gemini-2.5-flash-image" },
  "result": {
    "images": [
      {
        "url": "https://cdn.pictulab.com/…",
        "file_name": "…png",
        "mime_type": "image/png",
        "file_size": 1843211
      }
    ],
    "tokens_used": 6,
    "prompt": "…"
  },
  "error": null,
  "attempts": 1,
  "tokens_charged": 6,
  "created_at": "2026-10-07T08:00:00.000Z",
  "started_at": "2026-10-07T08:00:02.000Z",
  "completed_at": "2026-10-07T08:00:31.000Z"
}

result puede llegar como texto

En algunos casos result llega como una cadena JSON en lugar de un objeto. Compruébalo y parséalo:

const result = typeof job.result === 'string' ? JSON.parse(job.result) : job.result;

Estados

queued → processing → completed
                    ↘ failed
queued → cancelled

Estado	Significado
`queued`	En cola. Se puede cancelar.
`processing`	Generándose.
`completed`	Terminado. El resultado está en `result`.
`failed`	Ha fallado tras todos los intentos. El motivo está en `error` y los tokens se han devuelto.
`cancelled`	Cancelado desde la cola. Tokens devueltos.

Reintentos automáticos

Cada job tiene hasta 3 intentos. Ante un error transitorio vuelve a queued y error guarda el último mensaje.
Los errores permanentes (por ejemplo, contenido bloqueado o imagen inválida) no se reintentan.
Un job que pasa más de 15 minutos en processing sin respuesta se reencola o, si no le quedan intentos, se marca failed y se devuelven los tokens.

Retención

Los jobs terminados se eliminan 30 días después de completed_at. Guarda las URLs que necesites.

Errores

Código	Tipo	Causa
`404`	`NOT_FOUND`	El job no existe o no es de tu equipo.