> ## Documentation Index > Fetch the complete documentation index at: https://docs.wengaocloud.com/llms.txt > Use this file to discover all available pages before exploring further. # 查询 Gemini Omni 视频任务 > 查询 Gemini Omni 异步视频任务的状态、生成结果和计费用量。 建议轮询间隔不少于 3 秒，生产环境建议 5–10 秒。 查询 Gemini Omni 异步视频任务的状态、生成结果和计费用量。 ``` GET /v1/google-omni/videos/generations/{id} Authorization: Bearer ``` `id` 为 [创建 Gemini Omni 视频任务](/api/videos/google-omni-create-task) 返回的任务 ID，格式通常以 `vidtask_` 开头。 不要高频轮询。建议间隔 **5–10 秒**，最短不低于 3 秒。视频生成通常需要 30 秒至数分钟。 *** ## 示例 ```bash theme={null} curl "https://{your-domain}/v1/google-omni/videos/generations/vidtask_a52be4ce35e9466a83004b066f47aa67" \ -H "Authorization: Bearer $API_KEY" ``` *** ## 响应字段 | 字段 | 类型 | 说明 | | ------------------------------ | ------- | ------------------------------------------------------------------------------ | | `id` | string | 平台任务 ID。 | | `object` | string | 固定为 `video.generation.task`。 | | `created` | integer | 任务创建时间，Unix 秒。 | | `created_at` | integer | 任务创建时间，Unix 秒。 | | `updated_at` | integer | 任务状态最后更新时间，Unix 秒。 | | `model` | string | 平台模型名称。 | | `status` | string | 任务状态：`queued`、`running`、`succeeded`、`failed`、`cancelled`、`expired`。 | | `billing_status` | string | 账务状态：`frozen`、`settling`、`settled`、`refunded`、`settle_failed`、`refund_failed`。 | | `content.video_url` | string | 生成视频 URL，任务成功时返回。请及时下载和转存。 | | `content.video_url_expires_at` | string | 视频 URL 过期时间，RFC3339 格式。 | | `error.code` | string | 失败错误码。 | | `error.message` | string | 失败说明。 | | `usage.billing_unit` | string | 计费单位，Gemini Omni 为 `video_second`。 | | `usage.unit_name` | string | 单位名称，通常为 `video_second`。 | | `usage.requested_units` | string | 请求秒数。 | | `usage.billable_units` | string | 实际结算秒数。 | *** ## 响应示例 ```json 排队中 theme={null} { "id": "vidtask_a52be4ce35e9466a83004b066f47aa67", "object": "video.generation.task", "created": 1784300712, "created_at": 1784300712, "updated_at": 1784300712, "model": "gemini-omni-flash-preview", "status": "queued", "billing_status": "frozen" } ``` ```json 成功 theme={null} { "id": "vidtask_a52be4ce35e9466a83004b066f47aa67", "object": "video.generation.task", "created": 1784300712, "created_at": 1784300712, "updated_at": 1784300796, "model": "gemini-omni-flash-preview", "status": "succeeded", "billing_status": "settled", "duration": 10, "ratio": "1280x720", "content": { "video_url": "https://example.com/generated-video.mp4", "video_url_expires_at": "2026-07-20T12:00:00Z" }, "usage": { "billing_unit": "video_second", "unit_name": "video_second", "requested_units": "10", "billable_units": "10" } } ``` ```json 失败 theme={null} { "id": "vidtask_a52be4ce35e9466a83004b066f47aa67", "object": "video.generation.task", "created": 1784300712, "created_at": 1784300712, "updated_at": 1784300796, "model": "gemini-omni-flash-preview", "status": "failed", "billing_status": "refunded", "error": { "code": "failed", "message": "upstream task failed" } } ``` ## OpenAPI ````yaml GET /v1/google-omni/videos/generations/{id} openapi: 3.1.0 info: title: WengaoCloud AI Gateway API version: 0.1.0 description: WengaoCloud AI 聚合平台公开 API 契约草案，覆盖 OpenAI 兼容接口、Anthropic 原生接口和平台扩展接口。 servers: - url: https://xxx.wengaocloud.com description: 问高云 API 网关根域名。OpenAI SDK 的 base_url 使用 https://xxx.wengaocloud.com/v1。 - url: https://{tenant}.wengaocloud.com description: 控制台展示的租户或 OEM API 网关根域名。 variables: tenant: default: xxx security: - bearerAuth: [] tags: - name: models x-group: 模型 - name: openai-compatible x-group: OpenAI 兼容接口 - name: anthropic-native x-group: Anthropic 原生接口 - name: images-v3 x-group: 图片（V3 同步） - name: volcengine-images x-group: 图片（火山直连） - name: images x-group: 图片（V1 兼容） - name: async-images x-group: 图片异步任务 - name: aliwan-images x-group: 图片（百炼万相） - name: videos x-group: 视频 paths: /v1/google-omni/videos/generations/{id}: get: tags: - videos summary: 查询 Gemini Omni 视频任务 description: | 查询 Gemini Omni 异步视频任务的状态、生成结果和计费用量。 建议轮询间隔不少于 3 秒，生产环境建议 5–10 秒。 operationId: getGoogleOmniVideoGenerationTask parameters: - name: id in: path required: true schema: type: string description: 创建接口返回的任务 ID，格式通常以 `vidtask_` 开头。 responses: '200': description: Gemini Omni 视频任务状态与结果。 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationTaskResponse' examples: running: value: id: vidtask_a52be4ce35e9466a83004b066f47aa67 object: video.generation.task created: 1784300712 created_at: 1784300712 updated_at: 1784300740 model: gemini-omni-flash-preview status: running billing_status: frozen succeeded: value: id: vidtask_a52be4ce35e9466a83004b066f47aa67 object: video.generation.task created: 1784300712 created_at: 1784300712 updated_at: 1784300796 model: gemini-omni-flash-preview status: succeeded billing_status: settled duration: 10 ratio: 1280x720 content: video_url: https://example.com/generated-video.mp4 video_url_expires_at: '2026-07-20T12:00:00Z' usage: billing_unit: video_second unit_name: video_second requested_units: '10' billable_units: '10' failed: value: id: vidtask_a52be4ce35e9466a83004b066f47aa67 object: video.generation.task created: 1784300712 created_at: 1784300712 updated_at: 1784300796 model: gemini-omni-flash-preview status: failed billing_status: refunded error: code: failed message: upstream task failed '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: schemas: VideoGenerationTaskResponse: type: object required: - id - object - status properties: id: type: string example: vidtask_3cb6299b32d24f93a82e8a74b3e06161 object: type: string enum: - video.generation.task created: type: integer description: 任务创建时间，Unix 秒。 created_at: type: integer description: 任务创建时间，Unix 秒。 updated_at: type: integer description: 任务状态更新时间，Unix 秒。 model: type: string status: type: string enum: - queued - running - succeeded - failed - cancelled - expired description: | 任务状态：`queued`（排队中）、`running`（运行中）、`succeeded`（成功）、 `failed`（失败）、`cancelled`（已取消）、`expired`（已超时）。 billing_status: type: string enum: - frozen - settling - settled - refunded - settle_failed - refund_failed description: | 账务状态：`frozen`（已冻结）、`settling`（结算中）、`settled`（已结算）、 `refunded`（已退款）、`settle_failed`（结算失败）、`refund_failed`（退款失败）。 content: type: object description: 视频生成结果，任务成功且存在视频地址时返回。 properties: video_url: type: string description: 生成视频 URL，请及时下载和转存。 video_url_expires_at: type: string description: 视频 URL 过期时间，RFC3339 格式。 error: type: object properties: code: type: string message: type: string usage: type: object description: 用量信息，任务完成并完成用量统计后返回。Token 视频模型返回 token 字段；Grok Imagine 返回按秒计费字段。 properties: completion_tokens: type: integer total_tokens: type: integer billing_unit: type: string description: 计费单位，例如 `video_second`。 unit_name: type: string description: 单位名称，例如 `video_second`。 requested_units: oneOf: - type: string - type: number description: 请求单位数。Grok Imagine 中通常为请求的视频秒数。 billable_units: oneOf: - type: string - type: number description: 实际结算单位数。Grok Imagine 中通常为输出视频秒数。 billable_input_images: oneOf: - type: string - type: number description: 实际计费的输入图张数，存在时返回。 billable_output_seconds: oneOf: - type: string - type: number description: 实际计费的输出视频秒数，存在时返回。 input_charge_amount: oneOf: - type: string - type: number description: 输入图费用，存在时返回。 output_charge_amount: oneOf: - type: string - type: number description: 输出视频费用，存在时返回。 charge_amount: oneOf: - type: string - type: number description: 本次任务总费用，存在时返回。 seed: type: integer resolution: type: string ratio: type: string duration: oneOf: - type: integer - type: string frames: type: integer framespersecond: type: integer generate_audio: type: boolean service_tier: type: string expires_at: type: integer additionalProperties: true ErrorResponse: type: object properties: error: type: object properties: type: type: string example: invalid_request_error code: type: string example: model_endpoint_mismatch message: type: string example: 该模型不支持当前 endpoint。 responses: Unauthorized: description: API Key 缺失或无效。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: 资源不存在。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key x-default: sk-your-api-key ````