Skip to main content
POST
/
v1
/
veo
/
videos
Image to Video
curl --request POST \
  --url https://gptproto.com/v1/veo/videos \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "model": "<string>",
  "upsample": true,
  "reference": true,
  "aspect_ratio": "<string>",
  "images": [
    {}
  ]
}'
{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}

​
Overview

This endpoint provides image to video functionality.

​
Authentication

This endpoint requires authentication using a Bearer token.
​
Authorization
string
default:"sk-***********"
required
Your API key in the format: Bearer YOUR_API_KEY

​
Request Body

​
prompt
string
required
Prompt parameter
​
model
string
default:"veo3.1-pro"
required
The model to use for the request
​
upsample
boolean
default:"true"
Upsample parameter
​
reference
boolean
default:"false"
Reference parameter
​
aspect_ratio
string
default:"16:9"
Aspect Ratio parameter
​
images
array
Images parameter

​
Request Example

curl -X POST "https://gptproto.com/v1/veo/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A beautiful woman is dancing in a European and American style",
  "model": "veo3.1-pro",
  "upsample": true,
  "reference": false,
  "aspect_ratio": "16:9",
  "images": [
    "https://heyoo.oss-ap-southeast-1.aliyuncs.com/20251017_170918_yyy1.jpeg"
  ]
}'

​
Response

​
Success
200
Successful response
{
  "status": "success"
}

​
Error Responses

{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}