API 文档
Seedance API 参考手册
集成 Seedance 视频 AI 的完整 API 文档。通过文本提示和图片生成高质量视频。
REST API
JSON 响应
视频生成
身份认证
Seedance API 使用 Bearer Token 认证。请在 Authorization 请求头中包含您的 API 令牌：
Authorization: Bearer your-api-token-here
安全提示： 切勿在客户端代码或公开仓库中暴露您的 API 令牌。
基础 URL
所有 API 请求应发送至：
https://seedanceapi.org/v1
API 端点
POST
生成视频
/generate使用 AI 模型从文本提示词和图片生成高质量视频。
请求体
文字生成视频 (T2V)
{
"prompt": "cardi b bends over to pick up coins",
"mode": "text",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1
}图片生成视频 (I2V)
{
"prompt": "kissing",
"mode": "img2img",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1,
"image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}参数
| 参数 | 类型 | 描述 |
|---|---|---|
| prompt | 字符串 | 生成视频的文本描述 |
| mode | 字符串 | 生成模式："text" 表示文生视频，"img2img" 表示图生视频 |
| image_url | 字符串? | 输入图片 URL（img2img 模式必填） |
| resolution | 字符串 | 视频分辨率："480p"、"720p" 或 "1080p" |
| ratio | 字符串 | 视频宽高比（默认："adaptive"） |
| duration | 整数 | 视频时长（秒，默认：5） |
| framespersecond | 整数 | 每秒帧数（默认：24） |
| seed | 整数 | 随机种子，用于可重现结果（默认：-1） |
响应
{
"code": 200,
"message": "success",
"data": {
"task_id": "task_123456789"
}
}endpoints.generate.curl
文字生成视频 (T2V):
curl -X POST https://seedanceapi.org/v1/generate \
-H "Authorization: Bearer your-api-token" \
-H "Content-Type: application/json" \
-d '{
"prompt": "cardi b bends over to pick up coins",
"mode": "text",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1
}'图片生成视频 (I2V):
curl -X POST https://seedanceapi.org/v1/generate \
-H "Authorization: Bearer your-api-token" \
-H "Content-Type: application/json" \
-d '{
"prompt": "kissing",
"mode": "img2img",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1,
"image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}'GET
获取任务状态
/status?task_id=xxxx检查正在进行或已完成的视频生成任务的状态。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| task_id | 字符串 | 从生成端点返回的任务 ID |
响应
{
"code": 200,
"message": "success",
"data": {
"consumed_credits": 10,
"created_at": "2024-01-01T00:00:00Z",
"status": "completed",
"task_id": "task_123456789",
"user_request": {
"prompt": "A beautiful landscape with flowing water",
"model": "seedance-video-v1",
"duration": 5
},
"user_response": {
"video_url": "https://cdn.seedance.com/generated/video.mp4",
"last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
},
"provider_status": "success",
"model": "seedance-video-v1"
}
}endpoints.generate.curl
curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
-H "Authorization: Bearer your-api-token"错误处理
Seedance API 返回标准的 HTTP 状态码和错误消息：
HTTP 状态码
200OK
400Bad Request
401Unauthorized
429Rate Limited
500Server Error
错误响应格式
{
"code": 400,
"message": "Invalid request: The prompt parameter is required",
"error": "INVALID_REQUEST"
}最佳实践： 请始终优雅地处理错误，并在处理响应体之前检查 HTTP 状态码。
速率限制
100
请求/分钟
免费版
1000
请求/分钟
专业版
5000
请求/分钟
企业版
速率限制响应头： 每个响应都包含 X-RateLimit-Remaining 和 X-RateLimit-Reset 头信息，用于追踪您当前的使用情况。