Skip to main content
POST
/
v1
/
videos
/
generations
veo3.1-pro Interface
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "veo3.1-pro",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo3.1-pro",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 180,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 25.7,
    "user_group": "default"
  }
}

Authorizations

​
Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header when using:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
string
default:veo3.1-pro
required

Video generation model name

Example:

"veo3.1-pro"

​
prompt
string
required

Prompt describing what kind of video to generate, limited to 2000 tokens

Maximum string length: 2000
Example:

"A cat playing piano"

​
aspect_ratio
enum<string>
default:auto

Video aspect ratio. When set to auto: image-to-video will automatically select based on the input image ratio, text-to-video will automatically select based on the prompt content

Available options:
auto,
16:9,
9:16
Example:

"auto"

​
image_urls
string<uri>[]

Reference image URL list for image-to-video feature

Note:

  • Single request supports up to 2 images (1 image for first-frame video generation, 2 images for first-and-last-frame video generation)
  • Image size: no more than 10MB
  • Supported file formats: .jpg, .jpeg, .png, .webp
  • Image URLs must be directly viewable by the server, or the image URL should trigger direct download when accessed (typically these URLs end with image file extensions, such as .png, .jpg)
Maximum array length: 2
Example:
["http://example.com/image1.jpg"]
​
generation_type
enum<string>

Video generation mode, default matches based on image count, manual selection recommended. Available modes:

  • TEXT: Text to video
  • FIRST&LAST: First and last frame to video, supports 1~2 images
Available options:
TEXT,
FIRST&LAST
​
enhance_prompt
boolean
default:true

Whether to automatically translate the prompt to English. When enabled, non-English prompts will be automatically translated to English for better generation results

Example:

true

​
callback_url
string<uri>

HTTPS callback address after task completion

Callback Timing:

  • Triggered when task is completed, failed, or cancelled
  • Sent after billing confirmation is completed

Security Restrictions:

  • Only HTTPS protocol is supported
  • Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • URL length must not exceed 2048 characters

Callback Mechanism:

  • Timeout: 10 seconds
  • Maximum 3 retries on failure (retries after 1 second/2 seconds/4 seconds)
  • Callback response body format is consistent with the task query API response format
  • Callback address returning 2xx status code is considered successful, other status codes will trigger retry
Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video generation task created successfully

​
created
integer

Task creation timestamp

Example:

1757169743

​
id
string

Task ID

Example:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Actual model name used

Example:

"veo3.1-pro"

​
object
enum<string>

Specific task type

Available options:
video.generation.task
​
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

​
status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

​
task_info
object

Video task detailed information

​
type
enum<string>

Task output type

Available options:
text,
image,
audio,
video
Example:

"video"

​
usage
object

Usage and billing information