众扬汇 AI 开放平台 API 文档

Seedance图生视频

OpenAPI Specification

接口:POST /v2/videos/generations(完整地址 https://api.allyang.cn/v2/videos/generations),属统一格式接口。

鉴权:请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求体参数(application/json)

prompt、model、images 三项不可省略。

  • prompt:必填,string,文本提示,中英文皆可,上限 800 个字符(汉字与字母均按 1 个计),超出部分会被裁掉;例如「一只小猫在月光下奔跑。」
  • model:必填,string,模型标识,示例 doubao-seedance-1-0-pro-250528;备选 doubao-seedance-1-0-pro-250528(文生视频,以及基于首帧的图生视频) / doubao-seedance-1-0-lite-t2v-250428(文生视频) / doubao-seedance-1-0-lite-i2v-250428(图生视频,支持首帧、首尾帧、参考图) / doubao-seedance-2-0-260128 / doubao-seedance-2-0-fast-260128 / doubao-seedance-2.0-mini。
  • images:必填,array,参考图链接,元素为 string。
  • duration:可选,integer,出片时长(秒);该值被固定为 5,不能更改,模型恒定输出 5 秒视频(原文枚举含 5、10)。
  • resolution:可选,string,画质档位,可选 480p / 720p / 1080p。
  • ratio:可选,string,成品宽高比,可用 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21,另有 keep_ratio(与上传图片保持同一宽高比)与 adaptive(依上传图片自动挑最合适的宽高比)。
  • watermark:可选,boolean,是否叠加水印;水印落在视频右下角,标注「由人工智能生成」。
  • seed:可选,integer,随机数种子,用来控制内容随机性,取值须落在 [0, 2147483647] 区间;不传则由算法自行给出;想让产出相对稳定可复用同一数值。
  • camerafixed:可选,boolean,是否锁定镜头;true 锁定镜头(平台会在用户提示词中追加固定摄像头,实拍效果不作保证),false 不锁定。
  • return_last_frame:可选,boolean,仅 doubao-seedance-1-0-lite-i2v 支持;true 会在返回中附带尾帧图像(png 格式,像素尺寸与视频一致,不带水印,可经由查询视频生成任务接口取得),false 则不含尾帧。
  • generate_audio:可选,boolean,是否同时产出音频。

原文档请求示例中的示例字段写作 Example(示例值为英文提示词)。

响应

  • 200:成功。
  • task_id:string,任务编号,示例 cgt-20250831141439-sqmgf。

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。