创建 Gemini Omni 视频任务

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。"
  }
}

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 视频任务接口获取。

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`

任务失败、取消或超时后，平台会退款到对应 API Key 余额。

常见错误

场景	可能错误	处理方式
`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 可用模型和域名可见性。

授权

Authorization

string

header

默认值:sk-your-api-key

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

model

string

必填

平台开通的 Gemini Omni 视频模型名称。

示例:

"gemini-omni-flash-preview"

prompt

string

必填

视频提示词，描述主体、动作、环境、镜头、风格等。

示例:

"哥斯拉在未来感城市夜景中和一只巨大的怪兽激烈战斗，电影级镜头，低角度仰拍，雨夜霓虹，爆炸火光，震撼但画面帅气"

duration

视频时长（秒）。未传默认 10，当前单次最大 10。

示例:

10

size

string

视频尺寸，格式为 宽x高，例如 1280x720、720x1280、1920x1080。未传默认 1280x720。

示例:

"1280x720"

images

参考图 URL。可传数组，也可传英文逗号分隔字符串；最多 7 个公网可访问图片 URL。 Gemini Omni 支持纯文本生成，images 不是必填。

示例:

["https://example.com/reference-1.jpg"]

video

string

参考视频 URL。必须是公网可访问 URL。

示例:

"https://example.com/reference.mp4"

响应

任务已受理并进入队列。

string

必填

平台任务 ID，用于查询任务。

示例:

"vidtask_3cb6299b32d24f93a82e8a74b3e06161"

object

enum<string>

必填

可用选项:

video.generation.task

created

integer

必填

任务创建时间，Unix 秒。

model

string

必填

请求中的平台模型名称。

status

enum<string>

必填

初始状态，通常为 queued。

可用选项:

queued

expires_at

integer

任务过期时间估算，Unix 秒。

开始使用

API 参考

模型与计费

指南

参考

请求参数

示例

带参考图

响应示例

计费说明

常见错误

授权

请求体

响应

​请求参数

​示例

​带参考图

​响应示例

​计费说明

​常见错误

授权

请求体

响应

请求参数

示例

带参考图

响应示例

计费说明

常见错误