Gemini 视频任务提交（兼容地址）

POST/v1/gemini/models/{model}:predictLongRunning

Gemini 视频任务提交（兼容地址）

该接口仅用于兼容 Gemini 风格长任务地址，视频请求体、返回结构、鉴权、模型权限、余额预检、任务日志与计费链路均与 /v1/videos/generations 保持一致；路径中的 model 会作为默认模型写入请求体。Sora2 仅支持 720P（`size=1280x720/720x1280` 或 `resolution=720p`）；Veo3.1 按请求入参 `resolution` 判定清晰度与计费档位，未传时默认 720P。

基础信息

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

请求参数

Path

字段

类型

必填

位置

说明

model

string

是

path

视频模型 ID。

示例："sora-2"

Body

字段

类型

必填

位置

说明

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

请求示例

{
  "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 视频任务提交（兼容地址）

通过 Gemini 风格兼容路径提交视频生成任务。

Base URL Token / API Key

model

JSON 请求体 {}

提示：推荐优先使用 /v1/gemini/videos/generations；该地址仅作为 Gemini 风格兼容入口。

提示：返回 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/models/sora-2:predictLongRunning' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

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