Seedance 1.5 Pro 异步视频生成

API 文档

使用这些端点提交 Seedance 1.5 Pro 任务并检查其状态。每次调用都会根据时长和音频（同步对话、音效、音乐）消耗积分。

身份验证

所有请求必须在 Authorization header:

Authorization: Bearer <YOUR_API_KEY>

缺少或无效的密钥将返回 401 Unauthorized.

POST

https://seedance1-5pro.com/api/generate

创建生成任务

提交一个新的 Seedance 1.5 Pro 任务。调用会立即返回一个 task_id，同时渲染异步完成。

参数	类型	必需	描述
prompt	string (max 1000 chars)	是	主场景描述（文本或图像流程）。
aspect_ratio	string	是	支持：16:9, 9:16, 1:1。当 image_urls 存在时将被忽略。
duration	string	是	渲染时长，单位为秒（"5"或"10"）。
sound	boolean	否	在片段中包含音频（同步对话、音效、音乐）。
image_urls	string[]	否	可选的参考图像 URL（图像转视频所需）。

积分消耗

积分在任务创建时扣除。失败的任务将自动退款。

预设	扣除积分
5 秒静音	65
10 秒静音	130
5 秒带音频	130
10 秒带音频	260

请求示例

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8"
  }
}

GET / POST

https://seedance1-5pro.com/api/status

检查任务状态

使用此端点来轮询最新的记录。当任务仍处于 IN_PROGRESS（进行中）状态时，我们在回复之前会再次查询提供者。

参数	类型	必需	描述
task_id	string	是	由 /generate 返回的 ID。通过查询参数 (?task_id=) 或 JSON 正文发送。

字段	描述
task_id	从 /generate 返回的 ID。
status	SUCCESS（成功）
request	已清理的用户提交有效负载副本。
response	当 status 为 SUCCESS 时返回的媒体 URL 数组。
consumed_credits	任务消耗的积分（退款时为 0）。
error_message	当 status 为 FAILED 时返回的提供者错误信息。
created_at	任务存储时的 UTC 时间戳。

请求示例

GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

错误处理

401 Unauthorized - API 密钥缺失或无效。
402 Payment Required - 积分余额不足以支付扣除的费用。
429 Too Many Requests - 减少轮询频率或请求速率。
500 - 暂时性问题；请使用指数退避策略重试。