curl --request POST \
--url https://api.shuyou.ai/v1/predictions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo-3.1-fast-generate-preview",
"input": {
"prompt": "A cinematic shot of a majestic lion in the savannah at golden hour",
"aspect_ratio": "16:9",
"resolution": "720P",
"duration": 8,
"generate_audio": true
}
}
'{
"data": {
"task_id": "2c4d50261173430290971a2395a3b607",
"task_status": "processing"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}Google Gemini
Veo 3.1 Fast Generate Preview
Create asynchronous video tasks with veo-3.1-fast-generate-preview via POST /v1/predictions.
POST
/
v1
/
predictions
curl --request POST \
--url https://api.shuyou.ai/v1/predictions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo-3.1-fast-generate-preview",
"input": {
"prompt": "A cinematic shot of a majestic lion in the savannah at golden hour",
"aspect_ratio": "16:9",
"resolution": "720P",
"duration": 8,
"generate_audio": true
}
}
'{
"data": {
"task_id": "2c4d50261173430290971a2395a3b607",
"task_status": "processing"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}Overview
Google Veo 3.1 Fast Generate Preview (veo-3.1-fast-generate-preview) supports:
- Text-to-video —
promptonly - First / last frame —
first_frame_url,last_frame_url
veo-3.1-generate-preview (no reference-image mode).
Input parameters
| Field | Required | Default | Notes |
|---|---|---|---|
prompt | Yes | — | Max 1000 characters |
aspect_ratio | No | 16:9 | 16:9 or 9:16 only |
resolution | No | 720P | 720P, 1080P, 4K |
duration | No | 8 | 4, 6, or 8 (seconds) |
generate_audio | No | true | Include generated audio |
negative_prompt | No | — | Negative guidance text |
first_frame_url | No | — | First keyframe image URL |
last_frame_url | No | — | Last keyframe image URL |
Authorizations
Authorization: Bearer YOUR_API_KEY
Body
application/json
Model ID. Use veo-3.1-fast-generate-preview for this endpoint.
Available options:
veo-3.1-fast-generate-preview Example:
"veo-3.1-fast-generate-preview"
Show child attributes
Show child attributes
Optional HTTPS callback URL when the task completes, fails, or is cancelled.
Response
Async task created
Show child attributes
Show child attributes