curl --request POST \
--url https://xxx.wengaocloud.com/v1/google-omni/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-omni-flash-preview",
"prompt": "哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗,电影级镜头,低角度仰拍,雨夜霓虹,爆炸火光,震撼但画面帅气"
}
'{
"id": "vidtask_a52be4ce35e9466a83004b066f47aa67",
"object": "video.generation.task",
"created": 1784300712,
"model": "gemini-omni-flash-preview",
"status": "queued",
"expires_at": 1784473512
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}视频生成
创建 Gemini Omni 视频任务
创建 Gemini Omni 异步文生/图生视频任务。受理后立即返回任务 ID,视频生成结果通过查询接口获取。
gemini-omni-flash-preview 支持纯文本生成;如需参考图,可通过 images 传入公网可访问图片 URL。
curl --request POST \
--url https://xxx.wengaocloud.com/v1/google-omni/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-omni-flash-preview",
"prompt": "哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗,电影级镜头,低角度仰拍,雨夜霓虹,爆炸火光,震撼但画面帅气"
}
'{
"id": "vidtask_a52be4ce35e9466a83004b066f47aa67",
"object": "video.generation.task",
"created": 1784300712,
"model": "gemini-omni-flash-preview",
"status": "queued",
"expires_at": 1784473512
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}{
"error": {
"type": "invalid_request_error",
"code": "model_endpoint_mismatch",
"message": "该模型不支持当前 endpoint。"
}
}提交 Gemini Omni 异步视频生成任务。平台受理后立即返回任务 ID,视频生成结果通过 查询 Gemini Omni 视频任务 接口获取。
保存响应中的
任务失败、取消或超时后,平台会退款到对应 API Key 余额。
POST /v1/google-omni/videos/generations
Authorization: Bearer <API_KEY>
Content-Type: application/json
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定使用 gemini-omni-flash-preview,或使用平台返回的可用模型名称。 |
prompt | string | 是 | 视频提示词,描述主体、动作、环境、镜头、风格等。 |
duration | integer/string | 否 | 视频时长(秒)。未传默认 10,当前单次最大 10。 |
size | string | 否 | 视频尺寸,格式为 宽x高,例如 1280x720、720x1280、1920x1080。未传默认 1280x720。 |
images | string[]/string | 否 | 参考图 URL。可传数组,也可传英文逗号分隔字符串;最多 7 个公网可访问图片 URL。 |
video | string | 否 | 参考视频 URL。必须是公网可访问 URL。 |
Gemini Omni 支持纯文本生成视频,
images 不是必填。若需要参考图,请传公网可访问 URL;不要传本地文件路径、data:image/...;base64 或需要登录的临时 URL。示例
curl -X POST "https://{your-domain}/v1/google-omni/videos/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-omni-flash-preview",
"prompt": "哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗,电影级镜头,低角度仰拍,雨夜霓虹,爆炸火光,震撼但画面帅气,动作流畅,高质量科幻怪兽电影风格",
"duration": 10,
"size": "1280x720"
}'
import requests
resp = requests.post(
"https://{your-domain}/v1/google-omni/videos/generations",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"model": "gemini-omni-flash-preview",
"prompt": "哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗,电影级镜头,低角度仰拍,雨夜霓虹,爆炸火光,震撼但画面帅气",
"duration": 10,
"size": "1280x720",
},
)
print(resp.json())
const response = await fetch("https://{your-domain}/v1/google-omni/videos/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gemini-omni-flash-preview",
prompt: "哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗,电影级镜头,低角度仰拍,雨夜霓虹,爆炸火光,震撼但画面帅气",
duration: 10,
size: "1280x720",
}),
});
console.log(await response.json());
带参考图
{
"model": "gemini-omni-flash-preview",
"prompt": "参考图片中的角色,在未来城市中做电影感运镜",
"duration": 10,
"size": "1280x720",
"images": [
"https://example.com/reference-1.jpg",
"https://example.com/reference-2.jpg"
]
}
响应示例
{
"id": "vidtask_a52be4ce35e9466a83004b066f47aa67",
"object": "video.generation.task",
"created": 1784300712,
"model": "gemini-omni-flash-preview",
"status": "queued",
"expires_at": 1784473512
}
id,然后调用查询接口轮询任务状态。
计费说明
Gemini Omni 视频按视频秒数计费:| 字段 | 说明 |
|---|---|
billing_unit | video_second |
requested_units | 请求的 duration 秒数 |
billable_units | 任务成功后实际结算秒数,通常等于 duration |
常见错误
| 场景 | 可能错误 | 处理方式 |
|---|---|---|
prompt 为空 | prompt is required | 传入明确的视频提示词。 |
size 格式错误 | size must use widthxheight format | 使用 1280x720 这类宽高格式。 |
duration 超过上限 | duration exceeds max_billable_units_per_request 10 | 将 duration 调整到 10 秒以内。 |
| 图片 URL 需要登录、过期或被防盗链 | image_download_error / HTTP 403 | 换成可匿名下载的图片直链。 |
| 模型服务额度不足 | permission-denied / credits / spending limit | 联系平台处理额度。 |
| 模型未授权 | model_not_allowed / model_not_visible | 检查 API Key 可用模型和域名可见性。 |
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
平台开通的 Gemini Omni 视频模型名称。
示例:
"gemini-omni-flash-preview"
视频提示词,描述主体、动作、环境、镜头、风格等。
示例:
"哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗,电影级镜头,低角度仰拍,雨夜霓虹,爆炸火光,震撼但画面帅气"
视频时长(秒)。未传默认 10,当前单次最大 10。
示例:
10
视频尺寸,格式为 宽x高,例如 1280x720、720x1280、1920x1080。未传默认 1280x720。
示例:
"1280x720"
参考图 URL。可传数组,也可传英文逗号分隔字符串;最多 7 个公网可访问图片 URL。
Gemini Omni 支持纯文本生成,images 不是必填。
示例:
["https://example.com/reference-1.jpg"]
参考视频 URL。必须是公网可访问 URL。
示例:
"https://example.com/reference.mp4"
.png?fit=max&auto=format&n=v_sJS-AFS6goKAv3&q=85&s=e03202fddb83c95be2a503ab9c79163a)