Veo 3.1 API 国内直连 / 中转接入指南(gemini-veo31)
Veo 3.1 是 Google 的旗舰文生视频模型,画质强、支持 1080p,擅长电影感镜头与真实运动。在半页酥(byesu)平台上,它的模型名是 gemini-veo31,通过官方直连渠道接入(非逆向、非镜像),国内可直接调用,按秒计费,单价 $0.01875/秒(实际计费价与官网划线价在控制台实时可见)。
OpenAI 的 Sora API 将于 2026-09-24 官方关停,Veo 3.1 是当前主流的文生视频 API 替代方案之一。想在国内接入而不折腾网络的开发者,可直接走半页酥中转。
一句话:它是什么
- 模型:Google Veo 3.1 文生视频,平台模型名
gemini-veo31 - 能力:文生视频、图生视频(首帧参考图,≤2 张)、可选时长 4s / 6s / 8s、支持 1080p
- 计费:按秒计费,单价 $0.01875/秒(例:8 秒 ≈ $0.15),视频价格 = 单价 × 时长
- 接入:OpenAI 兼容异步接口,
https://byesu.com/v1,令牌用media / media-gen分组
如何调用(可直接跑)
Veo 3.1 是异步任务,三步走:创建任务 → 轮询状态 → 下载 mp4。
令牌必须用 media 分组
调用视频模型的令牌,必须属于 media / media-gen 分组,否则报「无可用渠道」。到 控制台 用该分组新建一个令牌即可。
1) 创建任务(curl)
curl https://byesu.com/v1/videos \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-veo31",
"prompt": "海浪拍打礁石,慢镜头,电影感,黄昏光线",
"seconds": "8",
"size": "1280x720"
}'返回里带任务 id 和 status。用它去轮询:
# 轮询状态(替换 {id})
curl https://byesu.com/v1/videos/{id} \
-H "Authorization: Bearer sk-你的令牌"
# 完成后下载 mp4
curl https://byesu.com/v1/videos/{id}/content \
-H "Authorization: Bearer sk-你的令牌" -o out.mp42) 完整流程(Python)
import requests, time
BASE = "https://byesu.com"
H = {"Authorization": "Bearer sk-你的令牌"}
# 1. 创建任务
task = requests.post(f"{BASE}/v1/videos", headers=H, json={
"model": "gemini-veo31",
"prompt": "海浪拍打礁石,慢镜头,电影感,黄昏光线",
"seconds": "8", # 时长(秒):4 / 6 / 8
"size": "1280x720", # 比例用尺寸表达;1920x1080 = 1080p
}).json()
# 2. 轮询直到完成(几十秒到几分钟都正常)
while task["status"] not in ("completed", "failed"):
time.sleep(5)
task = requests.get(f"{BASE}/v1/videos/{task['id']}", headers=H).json()
# 3. 下载 mp4(失败会自动退款,无需人工申诉)
if task["status"] == "completed":
mp4 = requests.get(f"{BASE}/v1/videos/{task['id']}/content", headers=H)
open("out.mp4", "wb").write(mp4.content)
print("已保存 out.mp4")3) 图生视频(用图片当首帧)
想让视频从一张图开始动起来,创建任务时改用 multipart/form-data,把首帧图片放在 input_reference 文件字段,其余参数作为表单字段一起传:
curl https://byesu.com/v1/videos \
-H "Authorization: Bearer sk-你的令牌" \
-F model="gemini-veo31" \
-F prompt="镜头缓缓推近,风吹动画面里的树叶" \
-F seconds="8" \
-F size="1280x720" \
-F input_reference=@first_frame.png轮询与下载步骤与文生视频完全一致。
关键参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
model | ✅ | 固定填 gemini-veo31 |
prompt | ✅ | 提示词。描述画面 + 动作 + 镜头,如「城市夜景航拍,车流光轨,环绕运镜」 |
seconds | 时长(秒),Veo 3.1 可选 4 / 6 / 8;不传取默认 | |
size | 用尺寸表达比例:1280x720(16:9)、720x1280(9:16)、1920x1080(1080p) | |
input_reference | 图生视频首帧图(≤2 张),仅 multipart 请求可用 |
轮询返回的 status 有 completed / failed 等状态;failed 会自动退款,不扣费。
按秒计费怎么算
Veo 3.1 单价 $0.01875/秒。总价 = $0.01875 × seconds。例:6 秒 ≈ $0.1125,8 秒 ≈ $0.15。实际计费价与官网划线价,在 生成工作台 选好时长后会直接显示。
为什么用 byesu 接入 Veo 3.1
- 官方直连不降智:走官方渠道调用,不是逆向或镜像,画质和能力与官方一致,稳定不掉链子。
- 国内直接可用:
https://byesu.com/v1公网可达,无需自己折腾网络环境即可调 Veo 3.1。 - 透明计价:$0.01875/秒 明码标价,控制台能看到实际计费价 + 官网划线价,按量扣费不含糊。
- 失败自动退款:视频任务是异步的,一旦生成失败,费用自动退回,不用人工申诉。
- 一个令牌接进程序:标准 OpenAI 兼容接口,Python / Node / 任意语言 HTTP 都能直接调。
- 6 语言文档 + 在线工作台:不想写代码可先用 生成工作台 出片验证效果。
相关链接
常见问题
Veo 3.1 国内能用吗?
能。通过半页酥(byesu)中转,接口地址 https://byesu.com/v1 国内公网可直接访问,无需自己折腾网络环境。模型名填 gemini-veo31,令牌用 media / media-gen 分组即可调用。
Veo 3.1 api 多少钱?
半页酥上 Veo 3.1(gemini-veo31)按秒计费,单价 $0.01875/秒。视频总价 = 单价 × 时长,例如 6 秒约 $0.1125、8 秒约 $0.15。控制台可看到实际计费价与官网划线价,视频任务失败会自动退款。
Veo 3.1 支持图生视频吗?
支持。创建任务时用 multipart/form-data 格式,把首帧图片放在 input_reference 文件字段(≤2 张),模型会从这张图开始生成动起来的视频。文生视频则用普通 JSON 请求,不传图即可。
调用 Veo 3.1 报「无可用渠道」怎么办?
几乎都是令牌分组选错了。视频模型必须用 media / media-gen 分组的令牌,到控制台新建一个该分组的令牌重试即可。同时确认模型名是 gemini-veo31,拼写要完全一致。
Veo 3.1 生成一段视频要多久?
视频生成比图片慢,几十秒到几分钟都正常。它是异步任务:创建任务后轮询 GET /v1/videos/{id} 查 status,变为 completed 后再用 /content 端点下载 mp4,不要重复创建任务。
Sora API 即将关停,Veo 3.1 是好的替代吗?
是。OpenAI 的 Sora API 将于 2026-09-24 官方关停,Veo 3.1 是当前主流的文生视频替代之一,画质强、支持 1080p 和图生视频。半页酥官方直连接入,单价 $0.01875/秒,失败自动退款,适合国内开发者迁移。