curl --request POST \
--url https://api.mixroute.ai/v1/video/generations \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}'
import requests
url = "https://api.mixroute.ai/v1/video/generations"
headers = {
"Authorization": "Bearer sk-xxxxxxxxxx",
"Content-Type": "application/json"
}
payload = {
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": False
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://api.mixroute.ai/v1/video/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxxxxxxxx',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'veo-3.1-fast-generate-preview',
prompt: '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
durationSeconds: 6,
aspectRatio: '16:9',
resolution: '1080p',
generateAudio: false
})
});
const data = await response.json();
console.log(data);
<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mixroute.ai/v1/video/generations', [
'headers' => [
'Authorization' => 'Bearer sk-xxxxxxxxxx',
'Content-Type' => 'application/json',
],
'json' => [
'model' => 'veo-3.1-fast-generate-preview',
'prompt' => '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
'durationSeconds' => 6,
'aspectRatio' => '16:9',
'resolution' => '1080p',
'generateAudio' => false
]
]);
echo $response->getBody();
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false,
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.mixroute.ai/v1/video/generations", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mixroute.ai/v1/video/generations"))
.header("Authorization", "Bearer sk-xxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'json'
uri = URI('https://api.mixroute.ai/v1/video/generations')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'
request['Content-Type'] = 'application/json'
request.body = {
model: 'veo-3.1-fast-generate-preview',
prompt: '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
durationSeconds: 6,
aspectRatio: '16:9',
resolution: '1080p',
generateAudio: false
}.to_json
response = http.request(request)
puts response.body
{
"task_id": "task_xxx",
"status": "pending",
"created_at": 1709459123
}
视频系列
Gemini原生(视频)
Google Veo 视频生成模型
POST
/
v1
/
video
/
generations
curl --request POST \
--url https://api.mixroute.ai/v1/video/generations \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}'
import requests
url = "https://api.mixroute.ai/v1/video/generations"
headers = {
"Authorization": "Bearer sk-xxxxxxxxxx",
"Content-Type": "application/json"
}
payload = {
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": False
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://api.mixroute.ai/v1/video/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxxxxxxxx',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'veo-3.1-fast-generate-preview',
prompt: '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
durationSeconds: 6,
aspectRatio: '16:9',
resolution: '1080p',
generateAudio: false
})
});
const data = await response.json();
console.log(data);
<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mixroute.ai/v1/video/generations', [
'headers' => [
'Authorization' => 'Bearer sk-xxxxxxxxxx',
'Content-Type' => 'application/json',
],
'json' => [
'model' => 'veo-3.1-fast-generate-preview',
'prompt' => '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
'durationSeconds' => 6,
'aspectRatio' => '16:9',
'resolution' => '1080p',
'generateAudio' => false
]
]);
echo $response->getBody();
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false,
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.mixroute.ai/v1/video/generations", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mixroute.ai/v1/video/generations"))
.header("Authorization", "Bearer sk-xxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'json'
uri = URI('https://api.mixroute.ai/v1/video/generations')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'
request['Content-Type'] = 'application/json'
request.body = {
model: 'veo-3.1-fast-generate-preview',
prompt: '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
durationSeconds: 6,
aspectRatio: '16:9',
resolution: '1080p',
generateAudio: false
}.to_json
response = http.request(request)
puts response.body
{
"task_id": "task_xxx",
"status": "pending",
"created_at": 1709459123
}
简介
Veo 是 Google Vertex AI 推出的多模态视频生成模型,支持 文生视频(T2V)、 首帧约束 与 首尾帧约束(仅 3.1 系列)生成连贯视频。通过 MixRoute 统一视频接口调用:先 提交任务 获取task_id,再 查询任务 轮询状态并获取结果。
认证
Bearer Token,如Bearer sk-xxxxxxxxxx
支持的模型
| 模型 ID | 说明 |
|---|---|
veo-3.0-fast-generate-001 | 文生视频、首帧模式,快速版(默认含音频) |
veo-3.1-fast-generate-preview | 文生视频、首帧/首尾帧模式,快速版 |
veo-3.0-generate-preview | 文生视频、首帧模式 |
veo-3.1-generate-preview | 文生视频、首帧/首尾帧模式 |
调用流程
- 提交任务:
POST /v1/video/generations,传入model、prompt及 Veo 专用参数。 - 轮询状态:
GET /v1/video/generations/{task_id},直到status为succeeded或failed。 - 获取结果:成功时响应中的
url为视频数据(Veo 可能为data:video/mp4;base64,...或 OSS 链接)。
Veo 专用参数
string
required
视频生成提示词,描述画面与动作。
integer
视频时长(秒),支持:
4、6、8。string
宽高比,仅支持:
16:9、9:16。string
分辨率:
720p、1080p。string
首帧参考图(URL 或 Base64),用于图生视频/首帧约束。
string
尾帧参考图(仅
veo-3.1 系列支持),与首帧配合实现首尾帧约束。boolean
是否生成同步音频。快速版模型会忽略该参数并始终包含音频。
integer
每次生成的视频数量,范围
1-4。personGeneration、addWatermark、seed)见 提交视频任务。
请求示例
- 提交 Veo 任务(文生视频)
- 查询任务状态
curl -X POST "https://api.mixroute.ai/v1/video/generations" \
-H "Authorization: Bearer sk-xxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}'
curl -X GET "https://api.mixroute.ai/v1/video/generations/{task_id}" \
-H "Authorization: Bearer sk-xxxxxxxxxx"
curl --request POST \
--url https://api.mixroute.ai/v1/video/generations \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}'
import requests
url = "https://api.mixroute.ai/v1/video/generations"
headers = {
"Authorization": "Bearer sk-xxxxxxxxxx",
"Content-Type": "application/json"
}
payload = {
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": False
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://api.mixroute.ai/v1/video/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxxxxxxxx',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'veo-3.1-fast-generate-preview',
prompt: '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
durationSeconds: 6,
aspectRatio: '16:9',
resolution: '1080p',
generateAudio: false
})
});
const data = await response.json();
console.log(data);
<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mixroute.ai/v1/video/generations', [
'headers' => [
'Authorization' => 'Bearer sk-xxxxxxxxxx',
'Content-Type' => 'application/json',
],
'json' => [
'model' => 'veo-3.1-fast-generate-preview',
'prompt' => '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
'durationSeconds' => 6,
'aspectRatio' => '16:9',
'resolution' => '1080p',
'generateAudio' => false
]
]);
echo $response->getBody();
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
payload := map[string]interface{}{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false,
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.mixroute.ai/v1/video/generations", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"model": "veo-3.1-fast-generate-preview",
"prompt": "清晨阳光洒在赛博城市的高楼群,镜头慢慢推进",
"durationSeconds": 6,
"aspectRatio": "16:9",
"resolution": "1080p",
"generateAudio": false
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mixroute.ai/v1/video/generations"))
.header("Authorization", "Bearer sk-xxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
require 'net/http'
require 'json'
uri = URI('https://api.mixroute.ai/v1/video/generations')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'
request['Content-Type'] = 'application/json'
request.body = {
model: 'veo-3.1-fast-generate-preview',
prompt: '清晨阳光洒在赛博城市的高楼群,镜头慢慢推进',
durationSeconds: 6,
aspectRatio: '16:9',
resolution: '1080p',
generateAudio: false
}.to_json
response = http.request(request)
puts response.body
{
"task_id": "task_xxx",
"status": "pending",
"created_at": 1709459123
}
⌘I