上传文件
为 Buble 生成任务上传图片、视频或音频素材。
上传文件
使用 POST /api/v1/files 在图生图、图生视频、视频生视频或音频辅助生成前上传源素材。
Endpoint
POST /api/v1/files
Content-Type: multipart/form-data表单字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
file | File | 是 | 图片、视频或音频文件。 |
file_type | string | 否 | image、video 或 audio。不传时按 MIME 类型推断。 |
model | string | 否 | 可选模型 key，用于模型级校验。 |
mode | string | 否 | 可选公开 mode，用于 mode 级校验。 |
如果传入 model 和 mode，Buble 会按照该模型模式校验文件类型、大小和格式。如果不传，则使用默认上传限制。
默认上传限制
| 类型 | 默认最大大小 |
|---|---|
| 图片 | 30 MB |
| 视频 | 100 MB |
| 音频 | 50 MB |
模型专属限制可能更严格。生产上传前建议先查看对应 模型参考。
上传图生图素材
curl https://buble.ai/api/v1/files \
-H "Authorization: Bearer $BUBLE_API_KEY" \
-F "file=@./source.png" \
-F "file_type=image" \
-F "model=google/nano-banana-pro" \
-F "mode=image_to_image"响应
{
"data": {
"object": "file",
"provider": "r2",
"url": "https://...",
"key": "api/image/xxx.png",
"file_type": "image",
"content_type": "image/png",
"size": 123456,
"filename": "source.png"
}
}根据所选 mode，把返回的 data.url 传入 image_urls、start_frame、end_frame、video_urls 或 audio_urls。