MaiopcMaiopc
微信微信
Maiopc

Seedance2.0 官方折扣版 - 创建任务

创建 Seedance2.0 官方折扣版视频任务，支持官方模型分辨率和 totalTokens 对账

POST/kyyReactApiServer/v1/seedance-discount/videos

Seedance2.0 官方折扣版创建任务

官方折扣版请使用完整模型编码创建视频任务. 创建成功后返回 id, 请使用查询任务接口获取最终视频. 任务成功后会返回 totalTokens, 便于对账.

认证

获取 Key
所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

modelstring必填
模型名称. 模型编码已包含模型类型, 分辨率, 以及是否包含视频参考.
  • sd_2.0_discount_480p
  • sd_2.0_discount_720p
  • sd_2.0_discount_1080p
  • sd_2.0_discount_480p_with_video_ref
  • sd_2.0_discount_720p_with_video_ref
  • sd_2.0_discount_1080p_with_video_ref
  • sd_2.0_fast_discount_480p
  • sd_2.0_fast_discount_720p
  • sd_2.0_fast_discount_480p_with_video_ref
  • sd_2.0_fast_discount_720p_with_video_ref
使用 _with_video_ref 模型时, content 中必须包含 role=reference_video 的 video_url.
resolutionstring
可选字段. 完整模型编码已包含分辨率. 如传入该字段, 必须与模型编码中的分辨率一致.
ratiostring
输出比例，默认 16:9。常用值：16:9、9:16、1:1、4:3、3:4、21:9。
durationinteger
视频时长，单位秒，默认 5，范围 4-15。
generate_audioboolean
是否生成音频，默认 true。
return_last_frameboolean
是否返回尾帧图片，默认 false。设置为 true 且任务生成尾帧时，可在查询接口读取 last_frame_url。
toolsarray
高级工具配置，默认不传。不同模型或场景支持的工具能力可能不同，请按实际开通能力传入。
seedinteger
随机种子，默认 -1，表示由模型服务随机生成。传入固定值可提升生成结果的可复现性；模型生成仍存在概率性，不保证完全一致。
contentarray必填
多模态内容数组。必须包含一个 type=text 的提示词。
content[].typestring必填
内容类型：text、image_url、video_url、audio_url。
content[].rolestring
素材角色：first_frame、last_frame、reference_image、reference_video、reference_audio。
content[].image_url.urlstring
图片地址。支持公网 URL 或素材引用 assetId://{assetId}。
content[].video_url.urlstring
视频地址。支持公网 URL。
content[].audio_url.urlstring
音频地址。支持公网 URL。
真人或虚拟人像图片建议先使用素材提交接口获取 assetId，再用 assetId://{assetId} 引用。

响应参数

idstring
视频生成任务 ID，用于查询任务状态和结果。
objectstring
对象类型，固定为 video。
createdinteger
任务创建时间戳。
modelstring
本次请求使用的模型名称。
statusstring
任务状态，创建成功后通常为 queued 或 processing。

状态说明

  • queued：任务已创建，等待处理。
  • processing：任务处理中。
  • completed：任务成功，可在查询接口中获取 video_url。
  • failed：任务失败，可在查询接口中查看 error。

请求报文示例

文生视频
{
  "model": "sd_2.0_fast_discount_720p",
  "ratio": "16:9",
  "duration": 5,
  "return_last_frame": true,
  "generate_audio": false,
  "content": [
    {
      "type": "text",
      "text": "一只可爱的小猫在草地上玩耍，镜头缓慢推进，画面明亮自然"
    }
  ]
}
首尾帧
{
  "model": "sd_2.0_discount_1080p",
  "ratio": "16:9",
  "duration": 5,
  "return_last_frame": true,
  "content": [
    {
      "type": "text",
      "text": "图中女孩对着镜头说茄子，360 度环绕运镜"
    },
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {
        "url": "https://example.com/first.jpeg"
      }
    },
    {
      "type": "image_url",
      "role": "last_frame",
      "image_url": {
        "url": "https://example.com/last.jpeg"
      }
    }
  ]
}