Veo 3.1 Generate Preview

curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo-3.1-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>"
  }
}

POST

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-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 Generate Preview (veo-3.1-generate-preview) supports:

Text-to-video — prompt only
First / last frame — first_frame_url, last_frame_url
Reference images — up to 3 URLs in reference_image_urls for consistent subject appearance

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
`reference_image_urls`	No	`[]`	Up to 3 reference image URLs

Authorizations

Authorization

string

header

required

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:veo-3.1-generate-preview

required

Model ID. Use veo-3.1-generate-preview for this endpoint.

Available options:

veo-3.1-generate-preview

Example:

"veo-3.1-generate-preview"

input

object

required

Show child attributes

webhook

string<uri>

Optional HTTPS callback URL when the task completes, fails, or is cancelled.

Response

Async task created

data

object

required

Show child attributes

Language Series

Image Series

Audio Series

Video Series

Provider Series

File Series

Task Management

Account Management

Veo 3.1 Generate Preview

Overview

Input parameters

Authorizations

Body

Response

​Overview

​Input parameters

Authorizations

Body

Response

Overview

Input parameters