SeeDance 2.0 API 测试说明

本模型为seedance满血版，不是fast版和mini版，生成视频效果和国内版完全一样，价格仅为国内seedance的一半左右，本模型已经有多个漫剧公司及电商公司在使用中，极少出现不稳定的情况（但是不能保证100%的稳定，因为价格很便宜，国内大客户渠道也只有8到9折的价格，我这里是5折左右）

一、API 测试说明文档

API KEY：

sk-5WJSJNWnJYM******

免费测试找微信 itlife888 获取API KEY。

1. 生成视频接口

接口地址：

POST https://wellapi.cc/v1/videos

接口参数说明

字段	类型	必填	说明
`model`	string	是	模型名称，如 `seedance2-720p`，`seedance2-1080p`
`prompt`	string	是	视频提示词；多素材时必须用 `@ImageN` / `@VideoN` 显式指代
`aspect_ratio`	string	是	画面比例，`16:9` / `9:16` / `1:1` / `4:3` / `3:4` / `21:9`
`resolution`	string	是	分辨率，分辨率，如 `720p`， `1080p`
`seconds`	string	是	时长（字符串类型），`5` ~ `15` 任意整数
`reference_images`	string[]	否	参考图数组，每项为公网 URL 或 data URL 参考图上限4张
`reference_mode`	string	否	参考模式，默认 `image_reference`；可选 `auto` / `start_frame` / `start_end` / `image_reference`
`reference_video`	string	否	单个参考视频，URL 或 data URL
`reference_videos`	string[]	否	多个参考视频，每项为 URL 或 data URL ，参考视频上限 3 个（每段 3-10s，合计 ≤ 15s）
`audio_mode`	string	否	参考视频音频模式：`auto`（默认）/ `keep_original`

参数@引用语法

上游不区分首尾帧 / 主体 / 场景，所有参考素材都进 reference_images 数组。模型靠 prompt 里的 @ImageN 来知道每张代表什么。

编号规则：@Image1 = reference_images[0]，@Video1 = reference_videos[0]，依此类推

多素材组合时必须用 @ 显式指代，否则模型会瞎猜

图片或视频入参引用示例：

prompt: "@Image1 的人物穿着白裙，在 @Image2 的场景里走过，镜头运动参考 @Video1"
reference_images: [人物图, 场景图]
reference_videos: [运镜参考视频]

入参示例

文生视频

{
    "model": "seedance2-720p",
    "prompt": "A cinematic tracking shot through a neon-lit rainy street at night, slow dolly-in, 35mm grain",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "seconds": "10"
  }

图生视频（单图 + @ 引用）

{
    "model": "seedance2-720p",
    "prompt": "@Image1 的人物开始慢慢走路，镜头跟随推进，shallow depth of field",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "seconds": "10",
    "reference_images": ["https://example.com/start.jpg"],
    "reference_mode": "image_reference"
  }

多素材组合（角色 + 场景 + 运镜）

{
  "model": "seedance2-720p",
  "prompt": "@Image1 character wearing white dress, walking in the setting from @Image2, camera motion following @Video1",
  "aspect_ratio": "21:9",
  "resolution": "720p",
  "seconds": "15",
  "reference_images": [
    "https://example.com/character.jpg",
    "https://example.com/setting.jpg"
  ],
  "reference_video": "https://example.com/camera-motion.mp4",
  "reference_mode": "image_reference",
  "audio_mode": "auto"
}

接口返回值示例：

{
    "id": "task_CInqIj8kqu4d8gVuYdc40Qc8oSRUzNZn",
    "task_id": "task_CInqIj8kqu4d8gVuYdc40Qc8oSRUzNZn",
    "object": "video",
    "model": "sora-v3-pro",
    "status": "processing",
    "progress": 10,
    "created_at": 1781704085,
    "seconds": "5",
    "size": "1280x720"
}

说明： 因为newapi系统不支持seedance 2.0，为了适配按sora模型处理了，所有seedance2接口返回的数据中的模型名称是soar，seedance2.0 满血版720P返回的字段中显示的是 sora-v3-pro，实际是 seedance2-720p 模型。
seedance2.0 满血版1080P返回的字段中显示的是 sora-v3-pro-1080p，实际是 seedance2-1080p 模型。
可以把生成的视频和字节跳动 seedance2.0 生成的视频对比。

2. 查询视频任务接口

接口地址：

GET https://wellapi.cc/v1/videos/{task_id}

示例：

https://wellapi.cc/v1/videos/task_XykXw4S4aZ8KKcj4sYpUpBlAYQ0IxEmy

其中 task_XykXw4S4aZ8KKcj4sYpUpBlAYQ0IxEmy 为上一步返回的 task_id 的值。

视频返回值示例：

{
    "id": "task_XykXw4S4aZ8KKcj4sYpUpBlAYQ0IxEmy",
    "size": "1280x720",
    "urls": [
        "https://xxx.com/generated/fc218293-0127-4b1d-8959-140b7aa8d20a/fc218293-0127-4b1d-8959-140b7aa8d20a_0.mp4"
    ],
    "error": null,
    "model": "sora-v3-pro",
    "usage": {
        "duration": 5,
        "total_tokens": 0,
        "completion_tokens": 0
    },
    "object": "video",
    "status": "completed",
    "created": 1781703825,
    "seconds": "5",
    "task_id": "fc218293-0127-4b1d-8959-140b7aa8d20a",
    "progress": 100,
    "video_url": "https://xxx/v1/videos/fc218293-0127-4b1d-8959-140b7aa8d20a/content",
    "created_at": 1781703825
}

关键字段说明：

字段	说明
status	任务状态：`processing`（处理中）/ `completed`（已完成）
progress	任务进度（0-100）
urls	视频文件直链地址列表
video_url	最终的视频访问地址 ✅
usage.duration	视频时长

📌 video_url 为最终的视频。

3. 下载视频

始终使用本接口下载，即使响应里有 video_url 字段也优先用这条代理路径。

4. 常见错误

HTTP	场景	说明
400	缺少 `model` 或 `prompt`	请求不完整
400	`invalid_json` / 类型错误	检查字段类型，特别是 SeeDance 的 `seconds` 必须是字符串
400	`seconds` 不在允许范围	SeeDance: 5-15；Veo: 写在模型名里不要传
400	`aspect_ratio` 或 `resolution` 不支持	见各模型限制表
400	`size` 与 `aspect_ratio` 冲突	Veo 二选一
400	参考图过多	seedance ≤ 4
401	令牌无效	检查 `Authorization`
409	任务未完成时下载	继续轮询任务状态
5xx	上游临时超时	稍后重试

附录 A：SeeDance 2.0 vs Veo 关键差异速查

维度	SeeDance 2.0	Veo
时长字段	`seconds`（字符串，5-15 任意 / 4-8-12）	写在模型名里（`-4s` / `-6s` / `-8s`），不要传 `seconds`
分辨率字段	`aspect_ratio` + `resolution` 两个独立字段	`size`（W×H 像素）一个字段
参考图字段	`reference_images` 数组	`image_url`（单图）/ `images`（多图）
参考视频	`reference_video` / `reference_videos`（仅 v3）	不支持
多素材指代	prompt 里用 `@Image1` / `@Video1` 显式指代	靠数组顺序（fast/std 首+尾，ref 全部当主体参考）
音频	`audio_mode`（仅有参考视频时有意义）	`generate_audio` 布尔（默认 true）
负面提示	不支持	`negative_prompt`

SeeDance 2.0 满血版5折卖，API文档

SeeDance 2.0 API 测试说明#

一、API 测试说明文档#

1. 生成视频接口#

参数@引用语法#

入参示例#

文生视频#

图生视频（单图 + @ 引用）#

多素材组合（角色 + 场景 + 运镜）#

2. 查询视频任务接口#

3. 下载视频#

4. 常见错误#

附录 A：SeeDance 2.0 vs Veo 关键差异速查#