30 秒用上 Veo 3
异步任务 API:创建任务后轮询,或用 Prefer: wait 挂起请求等待完成。POST /v1/videos
import time
import requests
BASE = "https://synthorai.io/v1"
HEADERS = {"Authorization": "Bearer sk-syn-..."}
# 1) create the video generation job (POST /v1/videos)
task = requests.post(
f"{BASE}/videos",
headers=HEADERS,
json={
"model": "veo-3.0-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p",
"duration": 5,
},
).json()
# 2) poll the job until it reaches a terminal state
while task["status"] in ("queued", "in_progress"):
time.sleep(5)
task = requests.get(f"{BASE}/videos/{task['id']}", headers=HEADERS).json()
# 3) completed → signed video URL (valid ~24h — download and store it promptly)
if task["status"] == "completed":
print(task["data"][0]["url"])
else:
print(task["error"])const HEADERS = {
Authorization: "Bearer sk-syn-...",
"Content-Type": "application/json",
};
interface VideoTask {
id: string;
status: "queued" | "in_progress" | "completed" | "failed" | "cancelled";
data?: Array<{ url: string }>;
error?: { code: string; message: string };
}
// 1) create the video generation job (POST /v1/videos)
const created = await fetch("https://synthorai.io/v1/videos", {
method: "POST",
headers: HEADERS,
body: JSON.stringify({
model: "veo-3.0-generate-001",
prompt: "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
resolution: "720p",
duration: 5,
}),
});
let task = (await created.json()) as VideoTask;
// 2) poll the job until it reaches a terminal state
while (task.status === "queued" || task.status === "in_progress") {
await new Promise((r) => setTimeout(r, 5000));
const res = await fetch(`https://synthorai.io/v1/videos/${task.id}`, { headers: HEADERS });
task = (await res.json()) as VideoTask;
}
// 3) completed → signed video URL (valid ~24h — download and store it promptly)
if (task.status === "completed") console.log(task.data?.[0]?.url);
else console.error(task.error);# Create the job; "Prefer: wait" holds the request up to 60s and returns the
# completed task when generation finishes in time (else the queued task).
curl https://synthorai.io/v1/videos \
-H "Authorization: Bearer sk-syn-..." \
-H "Content-Type: application/json" \
-H "Prefer: wait=60" \
-d '{
"model": "veo-3.0-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p",
"duration": 5
}'
# Still queued / in_progress? Poll until completed → data[0].url (valid ~24h).
curl https://synthorai.io/v1/videos/vid_9f2e8c1a4b7d \
-H "Authorization: Bearer sk-syn-..."package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"time"
)
const base = "https://synthorai.io/v1"
type videoTask struct {
ID string `json:"id"`
Status string `json:"status"`
Data []struct {
URL string `json:"url"`
} `json:"data"`
}
func call(method, url string, body []byte) (t videoTask) {
req, _ := http.NewRequest(method, url, bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer sk-syn-...")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
json.NewDecoder(resp.Body).Decode(&t)
return t
}
func main() {
// 1) create the video generation job (POST /v1/videos)
payload, _ := json.Marshal(map[string]any{
"model": "veo-3.0-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p",
"duration": 5,
})
task := call("POST", base+"/videos", payload)
// 2) poll the job until it reaches a terminal state
for task.Status == "queued" || task.Status == "in_progress" {
time.Sleep(5 * time.Second)
task = call("GET", base+"/videos/"+task.ID, nil)
}
// 3) completed → signed video URL (valid ~24h — download and store promptly)
if task.Status == "completed" {
fmt.Println(task.Data[0].URL)
}
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
// JDK built-in HttpClient — no extra dependency needed.
HttpClient http = HttpClient.newHttpClient();
// 1) create the job; "Prefer: wait=60" holds the request up to 60s and
// returns the completed task when generation finishes in time
HttpRequest create = HttpRequest.newBuilder(URI.create("https://synthorai.io/v1/videos"))
.header("Authorization", "Bearer sk-syn-...")
.header("Content-Type", "application/json")
.header("Prefer", "wait=60")
.POST(HttpRequest.BodyPublishers.ofString("""
{"model": "veo-3.0-generate-001",
"prompt": "a watercolor lighthouse at dawn, waves rolling in, camera pulling back",
"resolution": "720p", "duration": 5}"""))
.build();
String task = http.send(create, HttpResponse.BodyHandlers.ofString()).body();
System.out.println(task); // {"id":"vid_…","status":…} — completed → data[0].url
// 2) still queued / in_progress? Poll GET https://synthorai.io/v1/videos/{id} until the
// status turns completed, then download data[0].url (valid ~24h).关于 Veo 3
原生同步音频生成
有声或无声输出,分开计价
720p/1080p,4-8 秒
Veo 3 是 Google 的视频生成模型,也是为 Veo 产品线引入原生同步音频的一代。
- 它从文本提示词或首帧图像运作,产出 720p 或 1080p 的 .mp4 片段,24 fps、4、6 或 8 秒、16:9 或 9:16,并随视频一同生成对白、音效与环境音。
- generateAudio 开关在有声与无声输出之间选择;首尾帧插值与参考图要到 Veo 3.1 才出现,Google 现在把它列为推荐的后继者。
- Synthorai 通过异步 /v1/videos 任务 API 提供它——创建任务后轮询,或用 Prefer: wait 挂起调用——并按有声与无声各自的费率、以输出秒计费。
规格与限制
| 模态 | text + image → video |
| 特性 | vision |
| 分辨率 | 720p / 1080p |
| 时长 | 4 / 6 / 8 s |
| 帧率 | 24 fps |
| 宽高比 | 16:9 · 9:16 |
| 视频输入 | text-to-video · first-frame image-to-video |
| 原生音频 | 是——直接生成声音 |
| 格式 | .mp4 |
| 备注 | Google's Veo 3 video model, the generation that introduced native synchronized audio to the Veo line: text-to-video and first-frame image-to-video, 720p/1080p, 24 fps, 4/6/8 s, 16:9 and 9:16; a generateAudio switch selects sound-on vs silent output. First-and-last-frame interpolation and reference images arrive with Veo 3.1, which Google now lists as the recommended successor. Synthorai serves it via the async /v1/videos job API and bills per output second at separate sound-on and silent rates. |
常见问题
Veo 3 API 可以免费试用吗?
可以。新账号可获得 10 次试用调用和最高 $1 的免费额度,无需绑卡。足够在添加付款方式之前,用真实工作负载试一试 Veo 3。
Veo 3 最擅长什么?
原生同步音频生成,以及有声或无声输出,分开计价和720p/1080p,4-8 秒。完整能力请见 About 部分,内容取自厂商官方发布说明。
Veo 3 的价格是多少?
在 Synthorai 上,Veo 3 按每秒生成视频 $0.75 计费,仅成功生成才计费:按量付费,无平台加价,无需订阅。
如何调用 Veo 3 API 生成视频?
向 Synthorai 的 /v1/videos 发送 POST,model="veo-3.0-generate-001",创建一个异步任务;随后轮询任务状态,或加上 Prefer: wait 头把请求挂起等待,直到拿到视频 URL。无需厂商 SDK。
如何开通 Veo 3?
把现有 OpenAI SDK 的 base_url 指向 "https://synthorai.io/v1",model 设为 "veo-3.0-generate-001" 即可。一把 API key 通用网关上的全部模型。