API reference

Video generation veo-3.1-generate-preview

VEO unified video · Veo 3.1 generation (POST /v1/video/generations); poll with GET /v1/video/query after submit.

POST/v1/video/generations

Body Parametersapplication/json

image oneOf

Reference image for image-to-video (optional; URL or base64)

metadata object

Veo generation parameters (passed through to upstream parameters)

properties

aspectRatio string

Aspect ratio. Enum: 16:9 9:16

durationSeconds integer

Video duration in seconds

generateAudio boolean

Whether to generate audio (supported by some Veo models)

negativePrompt string

Negative prompt

resolution string

Resolution. Enum: 720p 1080p

model* string

Model name. Enum: veo-3.1-generate-preview veo-3.1-fast-generate-preview veo-3.0-generate-001 veo-3.0-fast-generate-001

prompt* string

Video content description (required)

Responses

200 application/json

response-200 object

400 Bad request or validation failed application/json

response-400 object

properties

error* object

Request Body Example Text-to-video veo-3.1-fast-generate-preview

2"metadata": {

3"aspectRatio": "16:9",

4"durationSeconds": 6

5},

6"model": "veo-3.1-fast-generate-preview",

7"prompt": "A close up of two people staring at a cryptic drawing on a wall"

Code Sample cURL

1curl -X POST "https://api.digislash.com/v1/video/generations" \

2-H "Content-Type: application/json" \

3-d '{

4"metadata": {

5"aspectRatio": "16:9",

6"durationSeconds": 6

7},

8"model": "veo-3.1-fast-generate-preview",

9"prompt": "A close up of two people staring at a cryptic drawing on a wall"

10}'

Response

1▼{

2"code": 0,

3▼"data": {

4"task_id": "task_example_001"

5},

6"message": "success"