xiangyangiai/API

API

通过接口把生成能力接入你的应用 · 与网页端同一套模型、计费与权限
MCP 接入 →
访问凭据绑定创建时所在的空间，按该空间的积分与权限执行
名称凭据空间最近使用调用
加载中…
快速开始
Base URL/open/v1鉴权Authorization: Bearer cpb_sk_…
bash
# 1. 提交图片生成（Idempotency-Key 防止重试时重复扣费）
curl -X POST /open/v1/generations \
  -H "Authorization: Bearer $CPB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"category":"image","prompt":"雨后老街，暖黄路灯，电影质感","ratio":"3:4","count":1}'

# 2. 等待结果（最多 30 秒）
curl "/open/v1/generations/<task_id>?wait=30" \
  -H "Authorization: Bearer $CPB_API_KEY"
接口
GET/open/v1/models可用模型、可选参数与计价规则
GET/open/v1/balance当前凭据所属空间的可用 / 冻结积分
POST/open/v1/generations提交生成任务（image / video / music / speech），需 Idempotency-Key
GET/open/v1/generations/{id}?wait=秒查询任务；wait 最多 30 秒，等待完成后返回
GET/open/v1/generations?limit=&before=任务列表（按创建时间倒序，before 为 ISO 时间游标）
生成参数
categoryimage | video | music | speech（必填）
prompt描述，最多 2000 字（必填）
modelId模型 ID，省略使用默认模型
ratio / resolution比例 / 清晰度，需在模型可选范围内
durationSec / count视频时长 / 图片张数
refAssetIds参考素材 ID（需为本人资产）
计费与限制
  • 提交时按模型价目冻结积分，成功后按成功数量结算，失败或取消返还；与网页端共用钱包与流水
  • 相同 Idempotency-Key 重复提交返回同一任务，不会重复扣费
  • 每个凭据每分钟最多 60 次请求；任务通过 API 提交后也会出现在网页端「项目」中（来源：API）
  • 结果 url / downloadUrl 为带有效期的签名地址，请及时下载转存
错误码
400参数错误：不在模型可选范围、缺少 Idempotency-Key 等
401凭据缺失、无效或已撤销
402积分不足
403账号停用、成员被停用或当前角色没有「生成内容」权限
429超过频控（每凭据每分钟 60 次），响应含 retryAfterSec
错误响应：{ "code": "insufficient_credits", "message": "…" }