POST
/
v1
/
videos
curl -X POST "https://api.applerouter.ai/v1/videos" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: multipart/form-data" \
  -F model="veo-3.1" \
  -F prompt="A cheerful cow doing the Kemusan dance" \
  -F seconds="8" \
  -F size="16x9"

{
  "id": "video_55cb73b3-60af-40c8-95fd-eae8fd758ade",
  "object": "video",
  "model": "veo-3.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1762336916,
  "seconds": "8",
  "size": "16x9"
}

​
Overview

Generate high-quality videos from text or images using Google Veo models (veo-3.1 series). Supports OpenAI compatible format.
​
model
string
required
Veo Model ID. Supports the following models:Standard
  • veo-3.1: Flagship model, highest generation quality
  • veo-3.1-fl: Flagship model (Flash Sale)
  • veo-3.1-fast: Fast model, faster generation speed
  • veo-3.1-fast-fl: Fast model (Flash Sale)
Landscape (16:9)
  • veo-3.1-landscape: Landscape flagship model
  • veo-3.1-landscape-fl: Landscape flagship model (Flash Sale)
  • veo-3.1-landscape-fast: Landscape fast model
  • veo-3.1-landscape-fast-fl: Landscape fast model (Flash Sale)
    Models with fl suffix are Flash Sale versions, offering better pricing.
​
prompt
string
required
Text description of the video (Prompt). Example: “A cheerful cow doing the Kemusan dance”
​
seconds
string
Video duration (seconds). Example: “8”.
​
size
string
Video size/aspect ratio. - 16x9: 1280x720 (Landscape) - 9x16: 720x1280 (Portrait)
​
input_reference
string
(Optional) Reference image. For image-to-video. Supports file upload or URL.
​
watermark
string
(Optional) Whether to add watermark. E.g. “false”.
curl -X POST "https://api.applerouter.ai/v1/videos" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: multipart/form-data" \
  -F model="veo-3.1" \
  -F prompt="A cheerful cow doing the Kemusan dance" \
  -F seconds="8" \
  -F size="16x9"

{
  "id": "video_55cb73b3-60af-40c8-95fd-eae8fd758ade",
  "object": "video",
  "model": "veo-3.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1762336916,
  "seconds": "8",
  "size": "16x9"
}

​
Check Status

Use GET /v1/videos/{task_id} to check task status and get results: 
curl -X GET "https://api.applerouter.ai/v1/videos/video_55cb73b3-60af-40c8-95fd-eae8fd758ade" \
  -H "Authorization: Bearer sk-your-api-key"

​
Chat API Support

Veo models can also be used via the Chat Completions API, suitable for multimodal interaction scenarios. 
{
  "model": "veo-3.1",
  "messages": [
    {
      "role": "user",
      "content": "Generate a video of a cat playing piano"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Body

multipart/form-data
​
model
string
required

支持 veo-3.1 系列模型（包括 -fast, -landscape 及 -fl 特价版）

Example:

"veo-3.1"

​
prompt
string
required

提示词

Example:

"让牛快乐的跳科目三"

​
seconds
string
required

时长

Example:

"8"

​
input_reference
file
required

垫图

​
size
string
required

720x1280 竖屏 1280x720 横屏

Example:

"16x9"

​
watermark
string
Example:

"false"

Response

200 - application/json
​
id
string
required
​
object
string
required
​
model
string
required
​
status
string
required
​
progress
integer
required
​
created_at
integer
required
​
seconds
string
required
​
size
string
required