Google Veo 3.1
Create a video task with this model, then query its result using the returned task ID.
Model ID google-veo3.1
Quickstart
Create an and set I2V_API_KEY. Set IDEMPOTENCY_KEY once for each new task. Reuse the key and identical payload when retrying that submission.
Submit a task
POST https://api.i2v.ai/api/v1/jobs/createTask
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "google-veo3.1",
"inputs": {
"prompt": "A calm lake at sunrise"
}
}'HTTP 200 means the task was accepted. Save the returned taskId.
{"taskId":"YOUR_TASK_ID"}Query the result
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"Replace YOUR_TASK_ID with the returned ID. Poll with backoff while the status is waiting or generating. Read output[].url on success, or inspect error on fail.
Parameters
Send model inputs inside inputs. Media URLs must be publicly accessible. Required media and supported combinations depend on the selected generation mode.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
inputs.prompt | string | No | — | Text describing the result or requested edit. |
inputs.resolution | string | No | — | Output resolution. Allowed 720p, 1080p, 4k. |
inputs.aspectRatio | string | No | — | Output aspect ratio. Allowed 16:9, 9:16. |
inputs.duration | number | No | — | Video duration in seconds. Allowed 8. |
inputs.urls | string[] | No | — |

