Skip to main content
POST
/
gemini
/
video
/
generate
create video generation task
curl --request POST \
  --url https://api.mountsea.ai/gemini/video/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "cat running on the road",
  "action": "text2video",
  "model": "veo2_fast",
  "videoId": "1234567890",
  "imageList": [
    "https://example.com/img1.jpg",
    "https://cdn.example.com/image2.png"
  ],
  "aspectRatio": "16:9",
  "translation": false,
  "cameraControl": "CAMERA_CONTROL_TYPE_CAMERA_CONTROL_STATIC"
}
'
{
  "taskId": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
prompt
string
required

video description, currently only supports English description

Example:

"cat running on the road"

​
action
enum<string>
required

video action, is one of the following: text2video, img2video, get1080p

Available options:
text2video,
img2video,
get1080p
Example:

"text2video"

​
model
enum<string>
required

if model is veo31_fast_ingredients, imageList is required (1~3 http(s) URLs)

Available options:
veo2_fast,
veo2_quality,
veo3_fast,
veo3_quality,
veo31_fast,
veo31_quality,
veo31_fast_ingredients
Example:

"veo2_fast"

​
videoId
string

videoId is required only when action is GET1080P; forbidden otherwise

Example:

"1234567890"

​
imageList
string[]

imageList is required only when action is IMG2VIDEO (1~2 http(s) URLs); otherwise it must be omitted or be an empty array []

Example:
[
  "https://example.com/img1.jpg",
  "https://cdn.example.com/image2.png"
]
​
aspectRatio
enum<string>

aspectRatio is optional, one of: 16:9, 9:16, 1:1, 3:4, 4:3

Available options:
16:9,
9:16,
1:1,
3:4,
4:3
Example:

"16:9"

​
translation
boolean

Whether to enable the automatic translation of prompt words, the default value is false

Example:

false

​
cameraControl
enum<string>
deprecated

cameraControl is deprecated and will be ignored

Available options:
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_MOVE_UP,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_MOVE_DOWN,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_MOVE_LEFT,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_MOVE_RIGHT,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_MOVE_FORWARD,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_MOVE_BACK,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_PAN_UP,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_PAN_DOWN,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_PAN_LEFT,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_PAN_RIGHT,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_ORBIT_LEFT,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_ORBIT_RIGHT,
CAMERA_CONTROL_TYPE_CAMERA_CONTROL_STATIC
Example:

"CAMERA_CONTROL_TYPE_CAMERA_CONTROL_STATIC"

Response

201 - application/json
​
taskId
string
required

task id, used to get task result later