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	Waiting to be processed	No
submitting	The request is being submitted	No
provider_processing	The generation is being processed	No
saving_result	The result is being saved	No
submission_unknown	Submission status needs confirmation; contact support	No
billing_reconciliation	The final price needs confirmation; contact support	No
succeeded	The result is ready	Yes
failed	The generation failed	Yes
canceled	The generation was canceled	Yes

Polling policy

Wait about five seconds after create.
Poll every 10–15 seconds; increase the interval after network or 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 one or more video or image artifacts. Every artifact has id, kind, artifact_index, role, content_type, size_bytes, and download_url. Image artifacts also include dimensions; decomposed layers include layer metadata. Seedance can additionally return an image with role: last_frame when requested. Download URLs expire; call GET again to receive freshly signed URLs for the same artifacts.

On success, billing.status is captured and billing.charged_amount is the final USD charge. On a failed or canceled generation it is released, the charged amount is zero, and the hold returns to the wallet. reconciliation_required means Gensta is still confirming the final amount.