限制与积分
理解 Buble API 的积分、并发、文件限制和生产集成注意事项。
限制与积分
积分
每次生成都会根据所选模型和参数消耗积分。图片模型通常使用固定积分价格；视频模型通常按秒计费，并可能叠加分辨率、音频等参数倍率。
积分消耗会在创建生成任务时由服务端计算。GET /api/v1/models 用于查询可调用模型、必需输入和可接受参数，而不返回内部价格配置。
并发
API 生成任务与网页端生成任务共享同一个用户级并发池。最大并发数取决于你的订阅方案。如果账号已有 pending 或 processing 任务，新的 API 请求也会受到同一套并发限制。
上传限制
默认上传限制如下：
| 文件类型 | 默认限制 |
|---|---|
| 图片 | 30 MB |
| 视频 | 100 MB |
| 音频 | 50 MB |
具体模型 mode 可能定义更严格的大小、格式、文件数量或时长限制。
生产集成注意事项
- 生成是异步任务，请围绕轮询设计集成。
- 生产请求建议显式传
mode。 - 如果工作流需要复用素材，请保存上传后返回的文件 URL。
- 当前公开 API 暂不包含 webhook、SDK 和 idempotency key。