Veo Alternate Route Video API

使用 -t public model IDs 创建异步 Veo video task，并用标准 task API 轮询。

使用 POST /v1/videos/generations 创建 -t public model IDs 的 Veo video task。

这些 models 和其他 media APIs 使用同一套 Xenodia task lifecycle，但 request parameters 比 base Veo3.1 models 更少。不要给 -t models 传 generationType、seeds、callBackUrl、enableFallback 或 enableTranslation。

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 只接受 public http 或 https image URL。不接受本地文件路径或 asset://... ID。

Supported public models

Model	Notes
`veo3.1-4k-t`	Veo 3.1 4K model；未传 `resolution` 时默认使用 `4k` pricing tier。
`veo3.1-components-4k-t`	Veo 3.1 Components 4K model；未传 `resolution` 时默认使用 `4k` pricing tier。
`veo3.1-pro-4k-t`	Veo 3.1 Pro 4K model；未传 `resolution` 时默认使用 `4k` pricing tier。
`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`	必填，上表中的任意 `-t` model ID。
`prompt`	必填文本 prompt。
`imageUrls`	可选 public `http` 或 `https` image URL，最多 3 个。
`channel_id`	可选 public route ID，来自 `/v1/models.available_channels`；不传则使用 automatic routing。
`aspect_ratio`	`16:9` 或 `9:16`。默认 `16:9`。
`resolution`	`720p`、`1080p` 或 `4k`。默认 `720p`；4K models 未传时默认 `4k`。
`duration`	可选；传入时必须是 `8`。
`watermark`	可选 boolean，默认 `false`。

Pricing

Veo -t models 按 accepted video task 固定计费，tier 由 request resolution 选择。

价格敏感 UI 上线前先查询 /v1/models。Capability payload 会暴露 capabilities.pricing.mode = "resolution" 和 720p、1080p、4k 三个 price tiers。

Response

返回 Xenodia media task envelope。轮询 task 直到 success 或 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
}