众扬汇 AI 开放平台 API 文档

Sora2文生视频

OpenAPI Specification

文生视频接口:按统一格式提交提示词与模型,异步生成视频并返回任务 ID,随后用「Sora2查询任务」接口查询结果。

请求方式:POST

接口地址

text
https://api.allyang.cn/v2/videos/generations

请求头

  • Content-Type(必填):请求体类型,按本页标注填写。(示例:application/json)
  • Authorization(可选):鉴权头,使用控制台创建的令牌,格式为 Bearer + 令牌。(示例:Bearer {{YOUR_API_KEY}})

请求参数(application/json)

  • prompt(string,必填)
  • model(string,必填)
    • 可选值:sora-2、sora-2-pro。
    • sora-2-pro:支持高清与 15 秒。
  • aspect_ratio(string,可选):输出画面的宽高比。
    • 可选值:16:9、9:16。
  • hd(boolean,可选):是否输出高清版本,缺省 false;开启后画面更清晰但耗时更长,仅 sora-2-pro 支持。
  • duration(string,可选):视频时长(秒);取值 25 仅 sora-2-pro 支持。
    • 可选值:10、15、25。
    • 25:25 秒仅 sora-2-pro 支持;取 25 时高清参数不生效。
  • notify_hook(string,可选):任务完成后的回调地址,示例占位 https://your-callback.example/callback(真实回调参数以接入时约定为准)。
  • watermark(boolean,可选):缺省 false。
  • private(boolean,可选):是否隐藏视频:true 时不对外发布且不可二次编辑(remix),缺省 false。

请求示例

json
{
  "prompt": "make animate",
  "model": "sora-2",
  "aspect_ratio": "16:9",
  "hd": false,
  "duration": "10"
}

返回:HTTP 200 表示成功,响应体字段待补(以实测为准)。

使用提示:审查不通过会导致生成中途失败,请避免违规提示词与真人素材;提交后请用查询接口轮询结果;耗时、限流与计费数值以本平台实测与计费页为准(待补)。