POST/v1/videos/generations

文生视频（豆包/通用视频）

平台兼容统一视频生成入口，并在需要时把请求中的 `duration` 映射为上游约定的 `seconds` 字段；接口当前返回平台任务 ID、统一状态和结果地址。Sora2 仅支持 720P（`size=1280x720/720x1280` 或 `resolution=720p`）；Veo3.1 按请求入参 `resolution` 判定清晰度与计费档位，未传时默认 720P。

基础信息

鉴权	Authorization: Bearer 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

请求示例

json

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

响应示例

json

{
  "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 · 浏览器直连网关

文生视频（豆包/通用视频）

提交豆包、cy 或其他通用视频生成任务，支持异步结果查询。

Base URL Token / API Key

JSON 请求体

提示：同一路径支持 application/json 与 multipart/form-data，字段保持一致。

提示：视频任务通常为异步执行，返回 PENDING 表示任务已提交、仍在排队或生成中，请配合任务查询接口轮询结果。

提示：Sora2 仅支持 720P，可传 size=1280x720/720x1280 或 resolution=720p，横竖版按同一档位计费。

提示：Veo3.1 优先按请求入参 resolution 判定清晰度与计费档位；未传 resolution 时默认 720P。

json

尚未发起请求。

bash

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

多语言示例

bash

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