API 文档

使用 API Key 接入 Seedance 视频/图片/LLM 生成服务

鉴权方式

所有 API 请求需在 Header 中携带 API Key

Authorization: Bearer bc_xxxxxxxxxxxxxxxxxxxxxxxx

API Key 在控制台 → API Key 管理中创建。每个 Key 可设置额度限制。

POST

https://www.duanjusns.cn/api/v1/video/generate

创建视频生成任务

请求体 (JSON)

{
  "modelId": "模型ID（从 /api/v1/models 获取）",
  "prompt": "生成提示词",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "imageUrls": ["https://...参考图URL"],
  "videoUrls": ["https://...参考视频URL"],
  "audioUrls": ["https://...参考音频URL"],
  "webhook_url": "https://your-callback.com/notify"
}

参数说明

参数	类型	必填	说明
modelId	string	是	模型 ID，从 /api/v1/models 获取
prompt	string	是	生成提示词，支持中英文
ratio	string	否	画面比例: 16:9 / 9:16 / 1:1，默认 16:9
resolution	string	否	分辨率: 480p / 720p / 1080p / 2k / 4k，默认 720p
duration	number	否	时长(秒): 5-30，具体上限由所选模型决定，默认 5
imageUrls	string[]	否	参考图片 URL 列表（公网可访问）
videoUrls	string[]	否	参考视频 URL 列表（需 H.264 编码，支持取决于所选模型）
audioUrls	string[]	否	参考音频 URL 列表（支持取决于所选模型）
webhook_url	string	否	任务完成后的回调地址

cURL 示例

curl -X POST https://www.duanjusns.cn/api/v1/video/generate \
  -H "Authorization: Bearer bc_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "sd2-pro-tj",
    "prompt": "一个女孩在夕阳下漫步",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "790a9221-23ee-4309-9841-545a3c3b9d90",
    "status": "running",
    "cost": 1.95
  }
}

GET

https://www.duanjusns.cn/api/v1/video/tasks/:id

查询视频任务状态

curl https://www.duanjusns.cn/api/v1/video/tasks/790a9221-23ee-4309-9841-545a3c3b9d90 \
  -H "Authorization: Bearer bc_xxxxxxxxxxxxxxxx"

响应示例

{
  "code": 0,
  "data": {
    "task_id": "790a9221...",
    "status": "success",
    "video_url": "https://sd.duanjusns.cn/videos/xxx.mp4",
    "cost": 1.95,
    "created_at": "2026-07-31T13:43:08Z",
    "finished_at": "2026-07-31T13:45:12Z"
  }
}

状态值: pending 排队中 → running 生成中 → transferring 转存中 → success 完成 / failed 失败

Base URL: https://www.duanjusns.cn

状态码: 200 成功 · 400 参数错误 · 401 鉴权失败 · 402 余额不足 · 429 请求过频 · 500 服务器错误

上传支持: JPEG/PNG/WebP 图片、MP4/MOV 视频（自动转码 H.265→H.264）、MP3/WAV 音频，最大 50MB

Webhook: 任务完成后 POST 回调，body 格式 {"task_id":"...","status":"success/failed","result_url":"..."}