Documentation
Job Polling
If you create an async generation job, poll it through GET /v1/images/generations/:id.
Use it when
- You requested a video
- You used a model that returns a job ID instead of a final asset
- You want to keep a loading UI in sync with generation status
Code examples
1curl https://api.navy/v1/images/generations/job_abc123def456 \
2 -H "Authorization: Bearer sk-navy-YOUR_KEY"Response statuses
queued— Job is waiting to be processedin_progress— Job is currently being generatedcompleted— Job finished; theresultfield contains the datafailed— Job failed; theerrorfield contains details
Notes
- Poll every 3–5 seconds. Video generation can take up to 10 minutes.
- Jobs expire after 10 minutes.
- Store job IDs so refreshes do not lose in-flight work.