API Reference

Create a video generation

Submit a video generation request and return a pending result.

POST /v1/generations

Body

Field	Type	Description
`action`required	string	create_video.
`model`required	string	Video model id or "auto".
`prompt`	string	Motion / subject description.
`params`	object	ratio, duration_s, quality.
`input_media_ids`	string[]	First/last frame or reference images.

Response

Returns a pending job with status queued. Poll GET /v1/generations/{id} for the result.

{
  "data": [
    {
      "id": "gen_7a1d...",
      "action": "create_video",
      "model": "grok-i2v",
      "status": "queued",
      "cost_credits": 24,
      "outputs": [],
      "error": null
    }
  ]
}