Sanbao OpenAPI

Seedance 视频生成 API

https://sanbaobeauty.com 后台创建 API Key

鉴权

所有 OpenAPI 请求都需要携带 API Key。API Key 在后台的“API 开放”里创建,并绑定到具体用户账号,扣费也从该用户积分余额中扣除。

Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx

也可以使用请求头:

X-API-Key: sk_sanbao_xxxxxxxxxxxxx

API 价格

API 调用从接入方的三宝影像工坊账号余额中扣除。接入方可在前台注册账号、充值积分,并在“API 接入”里创建 API Key。平台积分换算为 ¥1 = 10 积分。

用户选择 触发条件 API 扣费
Seedance 2.0 Fast ≤4 张图,且无音频/视频,未选人物一致 36 积分/次
Seedance 2.0 Fast >4 张图,或有音频/视频,或人物一致 42 积分/次
Seedance 2.0 720p ≤4 张图,且无音频/视频,未选人物一致 42 积分/次
Seedance 2.0 720p / 1080p >4 张图,或有音频/视频,或人物一致,或 1080p 57 积分/次

查询余额

curl https://sanbaobeauty.com/openapi/v1/me \
  -H "Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx"

创建视频任务

视频生成为异步任务。创建成功后会返回任务 ID,再用查询接口轮询结果。

POST /openapi/v1/videos
Content-Type: application/json
Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx
{
  "model": "seedance",
  "prompt": "一个电影感产品展示视频,金属香水瓶在黑色水面旋转,柔和轮廓光,高级广告质感",
  "ratio": "9:16",
  "resolution": "1080p",
  "duration": 5,
  "reference": "face",
  "images": [
    "https://example.com/reference-1.jpg"
  ],
  "videos": [],
  "audios": []
}

model

seedanceseedanceFast

resolution

seedanceFast 只支持 720pseedance 支持 720p1080p

reference

all 全能参考,startEnd 首尾帧,face 人物一致。

素材数量

最多 9 张图、3 条视频、3 条音频。素材 URL 需要公网可访问。

查询任务

GET /openapi/v1/videos/{taskId}
curl https://sanbaobeauty.com/openapi/v1/videos/task_xxx \
  -H "Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx"
{
  "data": {
    "id": "task_xxx",
    "status": "succeeded",
    "progress": 100,
    "video_url": "https://...",
    "cost": 57,
    "error": ""
  }
}

错误码

状态码说明
400参数错误,例如提示词过短、比例不支持、素材数量超限。
401API Key 缺失、无效或已停用。
402积分余额不足。
403账号被限制。
429请求过于频繁。
502模型服务异常。