Create Video Generation Task

Overview

Public model name	Currently supported video capabilities
veo3.1-video-720p	text-to-video, single-image-to-video, first-and-last-frame, multi-image-reference video generation, video extension
veo3.1-video-1080p	text-to-video, single-image-to-video, first-and-last-frame, multi-image-reference video generation, video extension
veo3.1-video-4k	text-to-video, single-image-to-video, first-and-last-frame, multi-image-reference video generation, video extension
veo3.1-fast-video-720p	text-to-video, single-image-to-video, first-and-last-frame, video extension
veo3.1-fast-video-1080p	text-to-video, single-image-to-video, first-and-last-frame, video extension
veo3.1-fast-video-4k	text-to-video, single-image-to-video, first-and-last-frame, video extension

Endpoint

POST /v1/video/generations

Query Parameters

Name	Type	Required	Description	Example
Authorization	string	No		Bearer {your_token}

Request Body Parameters

Field	Type	Required	Title	Description
model	string	Yes	Public model name
prompt	string	Yes	prompt	Structure Yes Required, recommended to pass
image	string	Yes	single source image URL	image-to-video
images	string	Yes	multiple reference images URL list	2 3 multi-image-reference video generation
last_image	string	Yes	URL	first-and-last-frame, andimage use
video	string	Yes	video UR	video extension
size	string	Yes	resolution	and Public Models
aspect_ratio	string	Yes	output aspect ratio	text-to-videoallowed values:16:9, 9:16; image-to-video, video extension use, pass
duration	string	Yes	,	allowed values:4, 6, 8; video extension use
extra_body	object	Yes	Field

Request Examples

text-to-video

{
  "model": "veo3.1-video-1080p",
  "prompt": " camera, camera. ",
  "size": "1080p",
  "aspect_ratio": "16:9",
  "duration": 8,
  "extra_body": {
    "generate_audio": true,
    "negative_prompt": ", blur",
    "seed": 7
  }
}

curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "veo3.1-video-1080p",
 "prompt": " camera, camera. ",
 "size": "1080p",
 "aspect_ratio": "16:9",
 "duration": 8,
 "extra_body": {"generate_audio": true,
 "negative_prompt": ", blur",
 "seed": 7}}'

single-image-to-video

{
  "model": "veo3.1-video-720p",
  "prompt": ", and. ",
  "image": "https://example.com/keyframe.png",
  "size": "720p",
  "aspect_ratio": "16:9",
  "duration": 6,
  "extra_body": {
    "generate_audio": false,
    "negative_prompt": "artifacts, "
  }
}

curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "veo3.1-video-720p",
 "prompt": ", and. ",
 "image": "https://example.com/keyframe.png",
 "size": "720p",
 "aspect_ratio": "16:9",
 "duration": 6,
 "extra_body": {"generate_audio": false,
 "negative_prompt": "artifacts, "}}'

first-and-last-frame

{
  "model": "veo3.1-fast-video-1080p",
  "prompt": ", subject, cameralanguage. ",
  "image": "https://example.com/start-frame.png",
  "last_image": "https://example.com/end-frame.png",
  "size": "1080p",
  "aspect_ratio": "16:9",
  "duration": 6,
  "extra_body": {
    "generate_audio": true
  }
}

curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "veo3.1-fast-video-1080p",
 "prompt": ", subject, cameralanguage. ",
 "image": "https://example.com/start-frame.png",
 "last_image": "https://example.com/end-frame.png",
 "size": "1080p",
 "aspect_ratio": "16:9",
 "duration": 6,
 "extra_body": {"generate_audio": true}}'

reference video

{
  "model": "veo3.1-video-1080p",
  "prompt": ", and. ",
  "images": [
    "https://example.com/ref-1.png",
    "https://example.com/ref-2.png"
  ],
  "size": "1080p",
  "aspect_ratio": "9:16",
  "duration": 6,
  "extra_body": {
    "generate_audio": true,
    "seed": 11
  }
}

curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "veo3.1-video-1080p",
 "prompt": ", and. ",
 "images": ["https://example.com/ref-1.png",
 "https://example.com/ref-2.png"],
 "size": "1080p",
 "aspect_ratio": "9:16",
 "duration": 6,
 "extra_body": {"generate_audio": true,
 "seed": 11}}'

video extension

{
  "model": "veo3.1-video-720p",
  "prompt": " video action, scenariostyle. ",
  "video": "https://example.com/source.mp4",
  "size": "720p",
  "duration": 6,
  "extra_body": {
    "negative_prompt": ", ",
    "seed": 9
  }
}

curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "veo3.1-video-720p",
 "prompt": " video action, scenariostyle. ",
 "video": "https://example.com/source.mp4",
 "size": "720p",
 "duration": 6,
 "extra_body": {"negative_prompt": ", ",
 "seed": 9}}'

Response Fields

Field	Type	Required	Title	Description

Response Examples

Example 1

{}