管理台CapCut2api API OpenAPI JSON

图片与视频 API

API 地址 https://f6.monster2.bbroot.com。媒体通过 https://monster.bbroot.com/f6/ 的签名链接按需交付。以当前部署配置返回的实际地址为准。

认证、账号与模型

客户端发送 Authorization: Bearer YOUR_API_KEY。在管理台导入已有 CapCut 账号并添加 API 密钥;工作台使用管理登录会话和 CSRF,无需填写客户端密钥。

账号支持邮箱密码登录导入、Cookie 头/结构化 Cookie 及明确类型的 sessionid token。凭据由服务端核验并加密保存。已有登录如需验证码,按返回错误中的当前要求处理。

{"email":"YOUR_CAPCUT_EMAIL","password":"YOUR_CAPCUT_PASSWORD","name":"账号备注"}
{"session":{"cookies":"sessionid=YOUR_SESSION","region":"sg"},"name":"账号备注"}
{"session":{"token_type":"sessionid","token":"YOUR_SESSION","region":"sg"}}

GET /v1/models?account_id=ACCOUNT_ID 返回当前账号已核验参数权限的可调用模型。GET /v1/models/MODEL_ID?account_id=ACCOUNT_ID&resolution=1k&ratio=1:1&quality=low 核验具体参数;视频可带 duration、generate_audio、reference_mode。目录记录、实现状态、账号权限和真实生成证据分别显示,发现记录本身不代表可调用。

图片生成

POST /v1/images/generations 或 POST /api/v1/tasks。使用目录中的完整模型编号;每次 n=1。ratio、resolution、quality 只接受所选入口声明的值,quality 仅在模型支持时提交。

curl https://f6.monster2.bbroot.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{"model":"capcut.image.direct.default.gpt_image_2","account_id":"ACCOUNT_ID","prompt":"A small green ceramic vase","ratio":"1:1","resolution":"1k","quality":"low","n":1}'

视频生成

POST /v1/videos,返回异步任务。duration 单位为秒,必须来自当前目录的枚举或范围;可选 generate_audio 仅适用于明确支持的模型。

{"model":"capcut.video.editor.default.seedance_1.0_fast","account_id":"ACCOUNT_ID","prompt":"A leaf moving gently in the wind","ratio":"16:9","resolution":"480p","duration":2,"reference_mode":"first_last_frame","n":1}

Editor 视频首尾帧使用 first_frame 和可选 end_frame。多模态参考使用 reference_mode=omni_reference、images 和 videos,只有目录明确支持此模式时可用。生成音轨参数是视频的一部分。

任务查询与原始媒体

创建返回 HTTP 202(首次接纳)或 200(同键已有请求),含 id、状态及 data。轮询 GET /api/v1/tasks/TASK_ID;视频也可使用 GET /v1/videos/TASK_ID。任务完成后 data[].url 为签名原始输出地址。视频内容接口为 GET /v1/videos/TASK_ID/content,需要相同 API 身份。

媒体支持 GET、HEAD 和单段 Range;每次查询任务可获得新的签名链接。链接有有效期,上游原始资源也可能到期;再次查询不能保证上游过期资源恢复。图片和视频按需流式传输,客户端应及时保存需要长期保留的文件。

参考素材

支持 JSON 的 images、videos 字段(公开 HTTP/HTTPS URL、签名网关 URL 或 Base64),以及 multipart/form-data 文件。图片字段用 images,MP4 用 videos;首尾帧用对应字段名。文件顺序即参考顺序。

单文件最多 20 MiB,总文件最多 200 MiB、16 个;每个模型可能有更紧的图片数、视频数、字节与总时长限制。图片支持 PNG/JPEG/WebP 等已声明格式;视频输入为 MP4。AI Lab/Studio 的素材绑定只有已验证接入后才开放。

curl https://f6.monster2.bbroot.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -F 'model=capcut.image.direct.default.gpt_image_2' \
  -F 'account_id=ACCOUNT_ID' -F 'prompt=A watercolor variation' \
  -F 'ratio=1:1' -F 'resolution=1k' -F 'quality=low' -F 'n=1' \
  -F 'images=@reference.png'

幂等、错误与费用

每次新生成使用唯一 Idempotency-Key。相同请求重用同一编号,参数或素材不同会返回冲突。请求超时或连接中断后,先查询原任务;若手动重发同一请求,必须沿用原编号。已提交或结果待确认的生成不会自动重新收费提交。

outcome_unknown 表示上游执行或费用尚未确认。错误返回 error.code、error.message 以及适用的安全诊断字段。HTTP 429/503 表示当前容量或服务状态限制,不能据此断定上游未收费;以返回的发送与回执证据为准。报价、任务预留和最终实扣分别记录,目录中的价格或 HTTP 200 不能代替真实生成验证。