Jobs & polling

Every generation request creates a job that runs asynchronously. Track it by polling GET /jobs/{job_id} until it reaches a terminal state.

Status values

status	Meaning	Terminal
queued	Accepted, waiting to be picked up.
processing	Currently generating.
done	Completed — result.image_url is ready.	✅
failed	Failed — see error.	✅

The job creation response always returns status: "queued". The status surfaced by GET /jobs/{job_id} uses processing (not queued) while actively generating.

Polling

Poll GET /jobs/{job_id} until status is done or failed. A short interval (e.g. 2 seconds) is typical.

curl -s https://api.moonez.ai/api/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer $API_KEY"

Warning

When status is done, result.image_url is a presigned URL valid for 1 hour. It is regenerated on every poll — always use the freshest value rather than caching an old one.

Tip

To avoid polling entirely, register a webhook and we'll notify you when the job reaches a terminal state.

See the full Get job reference for the response schema.