Veo Alternate Route Video API

-t public model IDs で非同期 Veo video task を作成し、標準 task API で polling する。

-t public model IDs の Veo video task には POST /v1/videos/generations を使います。

これらの 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 のみ受け付けます。local filesystem path と 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`	必須 text prompt。
`imageUrls`	optional public `http` または `https` image URLs。最大 3。
`channel_id`	optional public route ID。`/v1/models.available_channels` から取得します。省略時は automatic routing。
`aspect_ratio`	`16:9` または `9:16`。default `16:9`。
`resolution`	`720p`、`1080p`、`4k`。default `720p`。4K models は省略時 `4k`。
`duration`	optional。指定する場合は `8` のみ。
`watermark`	optional boolean。default `false`。

Pricing

Veo -t models は accepted video task ごとに、request resolution で選ばれる fixed amount を課金します。

価格表示 UI を作る前に /v1/models を問い合わせます。Capability payload は capabilities.pricing.mode = "resolution" と 720p、1080p、4k の price tiers を返します。

Response

Xenodia media task envelope を返します。task が success または fail になるまで polling します。

{
  "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
}