众扬汇 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。

  • prompt:string,必传;视频内容的文字描述,中英文都可以。原文档建议控制在 500 字以内——文字太长会稀释信息密度,模型可能只抓住重点而漏掉细节。
  • 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。
  • duration:integer,可选;不传时取 5。原文档的文字说明称该值被固定为 5、不允许修改,但枚举清单里同时列出了 5 与 10。
  • watermark:boolean,可选;不传时取 false,开启后会在画面右下角标注“由人工智能生成”。
  • seed:integer,可选;随机数种子,可填区间为 [0, 2147483647];不传时由算法随机取值,想保持结果相对稳定可固定同一个值。
  • resolution:string,可选;输出清晰度,可填 480p、720p、1080p,不传时取 480p。
  • return_last_frame:boolean,可选;不传时取 false。填 true 会额外带回视频尾帧图片,格式为 PNG,宽高与视频一致且不带水印,可再通过查询视频生成任务接口取回。
  • ratio:string,可选;不传时取 16:9。可填 21:9、16:9、4:3、1:1、3:4、9:16、9:21;也可填 keep_ratio,让输出比例与上传图片保持一致;或填 adaptive,由系统按上传图片挑选合适的宽高比。
  • camerafixed:boolean,可选;不传时取 false。填 true 会在用户的提示词后追加固定摄像头的描述,但原文档说明实际效果不做保证。
  • generate_audio:boolean,可选;原文档未给出该字段的文字说明。

响应

  • 200:返回 JSON 对象。
  • task_id:string,本次任务编号,示例值 cgt-20250831141439-sqmgf。

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