Skip to main content

​
Identifier

Use the model identifier grok-imagine-video in the model field when calling /asset/start.

​
Capabilities

PropertyValue
Reference inputs0–1
Aspect ratios16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 (default 9:16)
Resolutions480p, 720p (default 720p)
Durations (seconds)1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 (default 6)
Audiono

​
Inputs

Pass reference media in the references array (0–1 item). Optional. Each item accepts exactly one of:
  • url — a direct, publicly accessible file URL
  • asset_id — the ID of an existing asset in your Hoox space (e.g. a previous generation)
  • avatar_id — the ID of an avatar defined in your Hoox space

​
Pricing

Default parameters (6s at 720p): ~3 credits / generation. For exact pricing with your own parameters, call /asset/pricing with the model and any parameters that affect cost.

​
Example request

{
  "type": "video",
  "model": "grok-imagine-video",
  "prompt": "Describe what you want to generate",
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 6
}
See /asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.