Seedance 视频生成 API 参考

以 bytedance/seedance-2.0（Seedance 2.0）为例，演示提交任务、轮询状态与下载成片的完整调用流程。

字段	值
Base URL	`https://ai-api.easyapi.com`
认证	`Authorization: Bearer <API_KEY>`
示例模型	`bytedance/seedance-2.0`
格式	REST JSON（异步任务）
计费	按量计费

注意： Seedance 2.0 支持 4–15 秒时长、480p / 720p / 1080p 分辨率；流程为提交任务 → 轮询 job_id → 下载或访问 video_url。

示例模型

下文均以 bytedance/seedance-2.0 （Seedance 2.0）为例；更换其他模型时，请替换 model 参数，并参考控制台模型说明调整 size、quality 等字段。

提交视频生成任务

POSThttps://ai-api.easyapi.com/v1/videos

提交 Seedance 2.0 异步生成任务，成功返回 202 及 job_id（如 vid_seedance_8f3a2b1c）供后续轮询。建议传入 Idempotency-Key 以防重复创建。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer <API_KEY>
`Content-Type`	header	string	是	请求体格式，固定 application/json
`Idempotency-Key`	header	string	否	幂等键，相同 key 重复提交时返回首次创建的任务，不会重复创建

请求体

名称	类型	必选	说明
`model`	string	是	模型 ID，示例使用 bytedance/seedance-2.0
`prompt`	string	是	视频描述，建议包含主体、动作、场景、镜头和风格
`duration`	integer	否	Seedance 2.0 支持 4–15 秒
`resolution`	string	否	输出分辨率：480p、720p 或 1080p
`aspect_ratio`	string	否	宽高比：16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive
`generate_audio`	boolean	否	是否生成音频
`seed`	integer	否	随机种子，-1 到 4294967295；相同 seed 不保证完全一致
`size`	string	否	精确输出尺寸，如 1280x720（720p + 16:9）
`metadata`	object	否	业务透传字段，用于审计或来源标记
`webhook_url`	string	否	任务完成或失败后的回调地址

示例

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一只金毛犬在阳光明媚的海滩上奔跑，镜头缓慢跟随，电影感画面",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": false
}

响应示例

{
  "job_id": "vid_seedance_8f3a2b1c",
  "model": "bytedance/seedance-2.0",
  "status": "queued",
  "created_at": 1718452800
}

查询任务状态

GEThttps://ai-api.easyapi.com/v1/videos/{job_id}

示例请求： https://ai-api.easyapi.com/v1/videos/vid_seedance_8f3a2b1c

查询 Seedance 2.0 任务进度。以下示例轮询 job_id vid_seedance_8f3a2b1c，状态为 completed 时可获取 video_url。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer <API_KEY>
`job_id`	path	string	是	任务 ID，提交时返回，示例：vid_seedance_8f3a2b1c

响应示例

{
  "job_id": "vid_seedance_8f3a2b1c",
  "model": "bytedance/seedance-2.0",
  "status": "completed",
  "progress": 100,
  "video_url": "https://cdn.example.com/videos/vid_seedance_8f3a2b1c.mp4",
  "duration": 6,
  "resolution": "720p"
}

下载视频

GEThttps://ai-api.easyapi.com/v1/videos/{job_id}/content

示例请求： https://ai-api.easyapi.com/v1/videos/vid_seedance_8f3a2b1c/content

在 vid_seedance_8f3a2b1c 状态为 completed 后，通过此接口下载 Seedance 2.0 生成的视频文件流；也可直接使用上一步返回的 video_url。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer <API_KEY>
`job_id`	path	string	是	已完成任务的 job_id，示例：vid_seedance_8f3a2b1c

响应： HTTP 200，Content-Type 为 video/mp4 的二进制流；失败时返回 JSON 错误信息。