POST/v1/videos/generations

文生视频

平台兼容统一视频生成入口，并在需要时把请求中的 `duration` 映射为上游约定的 `seconds` 字段；接口当前返回平台任务 ID、统一状态和结果地址。`size` 参数支持透传 4K（如 `3840x2160`），但是否真正生成 4K 取决于上游模型能力与渠道配置。

基础信息

鉴权	Authorization: Bearer sk-...
请求类型	application/json
响应类型	application/json

请求参数

Body

字段

类型

必填

位置

说明

model

string

是

body

视频模型 ID。

示例："sora-2"

prompt

string

是

body

视频提示词。

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

size

string

否

body

输出分辨率（例如 1280x720、1920x1080、3840x2160）。

示例："3840x2160"

duration

integer

否

body

视频时长，秒。

示例：8

请求示例

json

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

响应示例

json

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

错误码

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

文生视频

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

Base URL Token / API Key

JSON 请求体

提示：视频任务通常为异步执行，请配合任务查询接口一起接入。

提示：4K 能力建议以“渠道模型 VIDEO 阶梯是否配置 4K + 厂商模型文档/实测结果”为准。

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": "3840x2160",
    "duration": 8
  }'