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 視訊 API 呼叫:先 提交任務 取得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