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 processed
  • in_progress — Job is currently being generated
  • completed — Job finished; the result field contains the data
  • failed — Job failed; the error field 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.
Docs Assistant
I’m here to help with NavyAI docs. Ask about endpoints, auth, models, request bodies, or integration details.