API Reference

Retrieve a generation

Fetch the current status and result of a generation job.

GET /v1/generations/{id}

Path

FieldTypeDescription
idrequiredstringThe generation id returned when the job was created.

Status values

queued, submitted, done, failed, canceled. Poll until a terminal status; on done the outputs array is populated.

Response

{
  "id": "gen_7a1d...",
  "action": "create_video",
  "model": "grok-i2v",
  "status": "done",
  "cost_credits": 24,
  "outputs": [{ "id": "med_c3d4...", "url": "https://cdn.dreamward.ai/..." }],
  "error": null
}