Skip to main content

​
Identifier

Use the model identifier veo-3.1 in the model field when calling /asset/start.

​
Capabilities

PropertyValue
Reference inputs0–1
Aspect ratios16:9, 9:16 (default 9:16)
Resolutions720p, 1080p, 4K (default 720p)
Durations (seconds)4, 6, 8 (default 8)
Audioyes

​
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

​
Custom settings

These keys go inside the model_settings object of the request body.
KeyTypeDefaultAffects cost
generateAudiobooleantrueyes

​
Pricing

Default parameters (8s at 720p): ~32 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": "veo-3.1",
  "prompt": "Describe what you want to generate",
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 8
}
See /asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.