Veo Alternate Route Video API

Create async Veo video tasks with the -t public model ids and poll them with the normalized task API.

Use POST /v1/videos/generations for Veo models that use the -t public IDs.

These models share the same Xenodia task lifecycle as other media APIs, but their request parameters are intentionally smaller than the base Veo3.1 models. Do not send generationType, seeds, callBackUrl, enableFallback, or enableTranslation with -t models.

Endpoint

POST https://api.xenodia.xyz/v1/videos/generations

Text-to-video request

{
  "model": "veo3.1-pro-t",
  "prompt": "A cinematic close-up of a developer dashboard showing model routing and API latency.",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 8
}

Reference request

{
  "model": "veo3.1-components-t",
  "prompt": "Animate the references into a polished product walkthrough.",
  "imageUrls": [
    "https://example.com/reference-1.png",
    "https://example.com/reference-2.png",
    "https://example.com/reference-3.png"
  ],
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 8,
  "watermark": false
}

imageUrls accepts public http or https image URLs only. Local filesystem paths and asset://... IDs are not accepted.

Supported public models

Model	Notes
`veo3.1-4k-t`	Veo 3.1 4K model. Defaults to the `4k` pricing tier when `resolution` is omitted.
`veo3.1-components-4k-t`	Veo 3.1 Components 4K model. Defaults to the `4k` pricing tier when `resolution` is omitted.
`veo3.1-pro-4k-t`	Veo 3.1 Pro 4K model. Defaults to the `4k` pricing tier when `resolution` is omitted.
`veo3.1-pro-t`	Veo 3.1 Pro model.
`veo3.1-t`	Veo 3.1 model.
`veo3.1-components-t`	Veo 3.1 Components model.
`veo3-pro-t`	Veo 3 Pro model.
`veo3-t`	Veo 3 model.

Parameters

Field	Notes
`model`	Required. One of the supported `-t` model IDs above.
`prompt`	Required text prompt.
`imageUrls`	Optional public `http` or `https` image URLs. Maximum 3.
`channel_id`	Optional public route ID from `/v1/models.available_channels`. Omit it for automatic routing.
`aspect_ratio`	`16:9` or `9:16`. Defaults to `16:9`.
`resolution`	`720p`, `1080p`, or `4k`. Defaults to `720p`; 4K models default to `4k` when omitted.
`duration`	Optional. If provided, must be `8`.
`watermark`	Optional boolean. Defaults to `false`.

Pricing

Veo -t models are billed once per accepted video task, selected by request resolution.

Query /v1/models before building price-sensitive UI. The model capability payload exposes capabilities.pricing.mode = "resolution" and one price tier each for 720p, 1080p, and 4k.

Response

The response returns a Xenodia media task envelope. Poll the task until it reaches success or fail.

{
  "task_id": "task_123",
  "object": "task",
  "model": "veo3.1-pro-t",
  "type": "video",
  "state": "waiting",
  "created_at": 1760000000,
  "poll_url": "/v1/tasks/task_123",
  "recommended_poll_interval_ms": 5000
}