# Veo 3 API (Veo 3.1) on Wizzx - Model ID: `veo3` (Google Veo 3.1) - Submit: `POST https://api.wizzx.ai/api/v1/task/submit/veo3` - Status: `GET https://api.wizzx.ai/api/v1/task/{task_id}` - Idempotency: optional `Idempotency-Key: ` header on submit - Auth: header `Authorization: Bearer $WIZZX_API_KEY` (server-side only) - Price: from $0.18/request, billed in credits; failed tasks are refunded - Page: https://wizzx.ai/model/veo3 - JSON Schema: https://wizzx.ai/api/models/veo3/schema - API reference: https://docs.wizzx.ai/api-reference/endpoint/submit-veo3 ## Flow 1. POST the JSON body to the submit URL. The response contains `data.task_id`. 2. Poll `GET /api/v1/task/{task_id}` until `data.status` is `SUCCEEDED`, then read the output URLs from `data.result_urls`. 3. Stop on `FAILED` or `REVIEW_REQUIRED`. Do not resubmit automatically. ## Parameters | Field | Type | Required | Default | Allowed | Description | |---|---|---|---|---|---| | `prompt` | string | yes | | | Describe the video you want to generate | | `model` | string | no | veo3_fast | veo3_fast · veo3_lite · veo3_quality | Fast balances fidelity and cost; Lite is the lower-cost high-volume option; Quality is the highest-fidelity option. | | `type` | string | yes | text-to-video | text-to-video · image-to-video · reference-to-video | | | `image_urls` | url[] ≤ 3 | no | | | Add first/last frames or up to 3 visual references for reference mode. | | `duration` | integer | no | 8 | 4 · 6 · 8 | Choose 4, 6, or 8 seconds. Reference to video supports 8 seconds only; Quality supports 6 or 8 seconds. | | `resolution` | string | no | 720p | 720p · 1080p · 4k | Resolution selects the fixed per-video price. | | `aspect_ratio` | string | no | 16:9 | 16:9 · 9:16 · Auto | | | `enable_translation` | boolean | no | true | | Translate prompt to English for better results | | `watermark` | string | no | | | Custom watermark text | | `seeds` | integer | no | | 10000 – 99999 | Random seed for reproducibility (10000-99999) | ## Example body ```json { "model": "veo3_fast", "type": "text-to-video", "duration": 8, "resolution": "720p", "aspect_ratio": "16:9", "enable_translation": true, "prompt": "A slow aerial push-in over a coastal cliff road at golden hour, cinematic motion" } ```