众扬汇 AI 开放平台 API 文档

Seedance首尾帧图生视频

OpenAPI Specification

接口:POST /v2/videos/generations(完整地址 https://api.allyang.cn/v2/videos/generations)

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

请求头

  • Authorization:可选,string,默认 Bearer {{YOUR_API_KEY}}。

请求体参数(application/json)

  • prompt:必填,string,文本提示,中英文均可,最长 800 个字符(每个汉字或字母计 1 个字符),超出部分会被截断。
  • model:必填,string,模型标识,示例 doubao-seedance-1-0-lite-i2v-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、10;原文另注明该参数固定为 5 且无法修改,与枚举取值不一致,实际以调用结果为准(待裁定)。
  • 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 时平台会在提示词中追加固定摄像头描述,实际效果不保证。
  • return_last_frame:可选,boolean,仅 doubao-seedance-1-0-lite-i2v 支持;为 true 时返回生成视频的尾帧图像(png,宽高像素值与视频一致、无水印),可通过查询视频生成任务接口获取。
  • generate_audio:可选,boolean,原文仅给出类型、未给出进一步说明(待补)。

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

响应

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

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