众扬汇 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、4、8、12。
    • 25:25 秒仅 sora-2-pro 支持。
  • images(array,必填):图片列表,支持 URL 与 base64 两种传入方式。
  • notify_hook(string,可选)
  • watermark(boolean,可选)
  • private(boolean,可选)

请求示例

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

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

使用提示:参考图建议使用公网可访问且访问速度较快的地址,图片访问慢会拉长整体耗时;提交后请用查询接口轮询结果;耗时、限流与计费数值以本平台实测与计费页为准(待补)。