视频与图片生成 API

鉴权

API 调用消耗账号积分。请先在三宝影像工坊注册账号、充值积分，再创建 API Key。

Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx

也可以使用请求头：

X-API-Key: sk_sanbao_xxxxxxxxxxxxx

模型与价格

平台积分换算为 1 元 = 10 积分。创建任务时先扣费；任务失败会自动退回本次扣除的积分。下表会自动同步当前可用模型；已下架或暂不可用模型不会出现在可用列表中。

素材可以传公网 http/https URL、data URL，或 base64 对象。图片单个最大 20MB；视频和音频限制以模型表返回为准。

查询账号

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

查询模型

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

响应中的 data 只包含当前可用模型。文档页模型表也使用同一份公开模型数据渲染。

上传素材

文档入口仍为 /docs.html。如果你不想直接提供自己的公网素材链接，推荐先把图片、视频、音频上传到三宝影像工坊，再把返回的地址用于创建任务。

POST /openapi/v1/uploads/raw?kind=image&fileName=ref1.jpg
Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx
Content-Type: image/jpeg

请求体为原始二进制文件，不是 JSON，也不是 multipart/form-data。请根据文件类型设置正确的 Content-Type，例如 image/jpeg、image/png、video/mp4、audio/mpeg。

{
  "file": {
    "url": "https://sanbaobeauty.com/uploads/xxx",
    "kind": "image",
    "contentType": "image/jpeg",
    "size": 123456
  }
}

curl 示例

curl -X POST "https://sanbaobeauty.com/openapi/v1/uploads/raw?kind=image&fileName=ref1.jpg" \
  -H "Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@ref1.jpg"

curl -X POST "https://sanbaobeauty.com/openapi/v1/uploads/raw?kind=video&fileName=clip.mp4" \
  -H "Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx" \
  -H "Content-Type: video/mp4" \
  --data-binary "@clip.mp4"

curl -X POST "https://sanbaobeauty.com/openapi/v1/uploads/raw?kind=audio&fileName=voice.mp3" \
  -H "Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx" \
  -H "Content-Type: audio/mpeg" \
  --data-binary "@voice.mp3"

如果你使用自己的 OSS 链接，仍需要保证三宝影像工坊服务器可以直接公网访问该文件，且不能有防盗链、私有权限、临时签名过期、不支持 Range 读取等限制；否则任务创建后可能无法拉取素材。生产接入时，更推荐先上传到我们的接口，再把返回的 file.url 用于创建任务。

创建视频任务

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

POST /openapi/v1/videos
Content-Type: application/json
Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx

{
  "model": "sd2_9img_full",
  "prompt": "高端护肤品商业广告，深夜都市办公室场景，女性对着电脑屏幕加班，镜头缓慢推进，电影级灯光，高级质感",
  "ratio": "9:16",
  "resolution": "720p",
  "duration": 5,
  "concurrency": 1,
  "reference": "all",
  "images": [
    "https://example.com/reference-1.jpg",
    {
      "tag": "图片1",
      "url": "https://example.com/reference-2.jpg"
    }
  ],
  "videos": [
    {
      "tag": "视频1",
      "url": "https://example.com/reference-video.mp4"
    }
  ],
  "audios": [
    {
      "tag": "音频1",
      "url": "https://example.com/reference-audio.mp3"
    }
  ]
}

创建图片任务

图片生成是异步任务。创建成功后返回任务 ID，再调用查询接口轮询结果。

POST /openapi/v1/images
Content-Type: application/json
Authorization: Bearer sk_sanbao_xxxxxxxxxxxxx

{
  "model": "gpt-image2",
  "prompt": "高端护肤品商业海报，玻璃瓶身，柔和棚拍灯光，高级质感",
  "aspect_ratio": "16:9",
  "images": [
    "https://example.com/reference-1.jpg"
  ],
  "quality": "high",
  "concurrency": 1
}

查询任务

GET /openapi/v1/videos/{taskId}
GET /openapi/v1/images/{taskId}

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

{
  "data": {
    "id": "task_xxx",
    "status": "succeeded",
    "progress": 100,
    "model": "sd2_9img_full",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "image_url": "",
    "images": [],
    "video_url": "https://...",
    "download_url": "https://...",
    "link_expires_in": 86400,
    "cost": 57,
    "error": "",
    "created_at": "2026-06-13T00:00:00.000Z",
    "updated_at": "2026-06-13T00:02:00.000Z"
  }
}

status 可能为 queued、processing、succeeded、failed。失败时请读取 error 字段展示给客户。

任务完成后，每次查询都会返回新的 video_url / download_url，链接为当前有效的签名媒体直链，默认约 24 小时有效；请以 link_expires_in 为准。

错误码