Gemini 视频任务提交

POST/v1/gemini/videos/generations

Gemini 视频任务提交

视频请求体与平台 /v1/videos/generations 保持一致，除请求地址外字段、鉴权、模型权限、余额预检、任务日志与计费链路保持一致；同时支持 application/json 与 multipart/form-data。Sora2 仅支持 720P（`size=1280x720/720x1280` 或 `resolution=720p`）；Veo3.1 按请求入参 `resolution` 判定清晰度与计费档位，未传时默认 720P。

基础信息

鉴权	Authorization: Bearer sk-... / x-goog-api-key: sk-... / ?key=sk-...
请求类型	application/json / multipart/form-data
响应类型	application/json

请求参数

Body

字段

类型

必填

位置

说明

model

string

是

body

视频模型 ID。

示例："sora-2"

prompt

string

是

body

视频提示词。

示例："一段展示开发者门户产品页的镜头推进动画"

size

string

否

body

输出尺寸。Sora2 仅支持 1280x720 或 720x1280，均按 720P 档位计费；Veo3.1 的清晰度请使用 resolution 字段。

示例："1280x720"

resolution

string

否

body

清晰度。Sora2 仅支持 720p；Veo3.1 支持 720p 或 1080p，未传默认 720p。

示例："720p"

duration

integer

否

body

视频时长，秒。

示例：8

请求示例

{
  "model": "sora-2",
  "prompt": "一段展示开发者门户产品页的镜头推进动画",
  "size": "1280x720",
  "duration": 8
}

响应示例

{
  "id": "123",
  "upstream_task_id": "task_abc123",
  "status": "PENDING",
  "result_url": null
}

响应字段

字段

类型

必填

位置

说明

id

string

否

body

平台任务 ID。

示例："123"

upstream_task_id

string

否

body

上游任务 ID。

示例："task_abc123"

status

string

否

body

任务状态。PENDING 表示任务已提交、仍在排队或生成中；请用任务查询接口继续轮询，直到 SUCCEEDED 或 FAILED。

示例："PENDING"

result_url

string

否

body

最终视频下载地址。

示例："https://download.example.com/video_task_123.mp4"

progress

integer

否

body

任务进度。

示例：42

error

object

否

body

失败时返回的错误对象。

code

string

否

body

错误码。

示例："video_task_failed"

message

string

否

body

错误信息。

示例："Task failed"

错误码

HTTP	code	说明
400	invalid_request_error	请求体结构不合法、缺少必填参数，或 JSON 无法解析。
401	invalid_auth_header	缺少或传错鉴权头，网关无法识别当前调用身份。
403	model_not_allowed	当前 API Key 没有访问该模型的权限。
402	insufficient_balance	余额不足，平台在调用前预检时已拒绝请求。
503	model_not_available	当前模型没有可用路由或上游渠道不可用。

在线调试

Playground · 浏览器直连网关

Gemini 视频任务提交

提交视频生成任务，支持异步结果查询。

Base URL Token / API Key

JSON 请求体 {}

提示：同一路径支持 application/json 与 multipart/form-data，字段与 /v1/videos/generations 完全一致。

提示：返回 PENDING 表示任务已提交、仍在排队或生成中；查询任务可使用 /v1/gemini/videos/generations/{taskId} 或 /v1/gemini/operations/{taskId}。

提示：Sora2 仅支持 720P；Veo3.1 优先按 resolution 判定清晰度与计费档位。

尚未发起请求。

curl --location --request POST 'https://api.harnmodel.com/v1/gemini/videos/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

curl --location --request POST 'https://api.harnmodel.com/v1/gemini/videos/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "一段展示开发者门户产品页的镜头推进动画",
    "size": "1280x720",
    "duration": 8
  }'