Skip to main content

​
Identifier

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

​
Capabilities

PropertyValue
Reference inputs1
Input typesvideo
Aspect ratios16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 (default 16:9)
Resolutions480p, 720p (default 720p)
Audiono
Tagsvideo-edit

​
Inputs

This model takes named media inputs. Pass each one as a top-level field in the request body (not inside references). Each field accepts exactly one of url, asset_id, or avatar_id.
FieldTypeRequiredDescription
source_videovideoyesVideo to edit. The prompt describes the modifications to apply.
  • 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 (720p): ~4 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-edit",
  "prompt": "Describe what you want to generate",
  "source_video": {
    "url": "https://example.com/reference.mp4"
  },
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
See /asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.