Status and results · Gensta API Docs

Get a generation

GET/v1/generations/{id}Bearer key · generations:read

bash

curl --silent --show-error --fail-with-body \
  "https://api-platform.gensta.ai/v1/generations/$GENERATION_ID" \
  -H "Authorization: Bearer $GENSTA_API_KEY"

Statuses

Status	Meaning	Terminal
queued	Accepted and waiting for provider submission	No
submitting	Creating exactly one provider task	No
provider_processing	The provider is generating the video	No
saving_result	Gensta is copying the result into permanent storage	No
submission_unknown	The provider may have accepted the task, but no unambiguous task ID was received	No · operator review
billing_reconciliation	The artifact exists, but usage and billing need operator review	No · operator review
succeeded	Artifact saved and billing settled	Yes
failed	Generation failed; inspect error	Yes
canceled	Provider reported cancellation	Yes

Polling policy

Wait about five seconds after create.
Poll every 10–15 seconds with jitter; back off on network and 5xx errors.
Stop on succeeded, failed, or canceled.
For submission_unknown or billing_reconciliation, retain the ID, poll less often, and contact support. Do not create a replacement job.

Download artifacts

Before success, artifacts is normally empty. A successful response contains a video artifact with content_type, size_bytes, and download_url. Download URLs expire; call GET again to receive a freshly signed URL for the same artifact.