bkend-storage
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesebkend.ai Storage Guide
bkend.ai 存储指南
Upload Methods
上传方式
| Method | Use Case | Process |
|---|---|---|
| Single | Normal files | Presigned URL -> PUT upload -> Register metadata |
| Multiple | Multiple files | Repeat single upload |
| Multipart | Large files | Initialize -> Part URLs -> Complete |
| 方式 | 使用场景 | 流程 |
|---|---|---|
| 单文件 | 普通文件 | 生成Presigned URL → PUT上传 → 注册元数据 |
| 多文件 | 多个文件 | 重复单文件上传流程 |
| 分片上传 | 大文件 | 初始化 → 获取分片URL → 完成上传 |
Presigned URL
Presigned URL
- Validity: 15 minutes
- PUT method with file binary
- Content-Type header required
- 有效期：15分钟
- 使用PUT方法上传文件二进制数据
- 必须包含Content-Type请求头
File Visibility (4 levels)
文件可见性（4个级别）
| Level | Access | URL Type |
|---|---|---|
| public | Anyone | CDN URL (no expiry) |
| private | Owner only | Presigned URL (1 hour) |
| protected | Authenticated users | Presigned URL (1 hour) |
| shared | Specified targets | Presigned URL (1 hour) |
| 级别 | 访问权限 | URL类型 |
|---|---|---|
| public（公开） | 任何人可访问 | CDN URL（无过期时间） |
| private（私有） | 仅文件所有者可访问 | Presigned URL（1小时有效期） |
| protected（受保护） | 已认证用户可访问 | Presigned URL（1小时有效期） |
| shared（共享） | 指定对象可访问 | Presigned URL（1小时有效期） |
Size Limits
大小限制
| Category | Max Size |
|---|---|
| Images | 10 MB |
| Videos | 100 MB |
| Documents | 20 MB |
| 类别 | 最大大小 |
|---|---|
| 图片 | 10 MB |
| 视频 | 100 MB |
| 文档 | 20 MB |
Storage Categories
存储分类
images, documents, media, attachments
图片、文档、媒体、附件
REST Storage API
REST存储API
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/files/presigned-url | Generate presigned URL |
| POST | /v1/files | Register metadata (complete upload) |
| GET | /v1/files | File list |
| GET | /v1/files/{id} | File detail |
| PATCH | /v1/files/{id} | Update metadata |
| DELETE | /v1/files/{id} | Delete file |
| GET | /v1/files/{id}/download-url | Generate download URL |
| 请求方法 | 接口地址 | 描述 |
|---|---|---|
| POST | /v1/files/presigned-url | 生成Presigned URL |
| POST | /v1/files | 注册元数据（完成上传） |
| GET | /v1/files | 文件列表 |
| GET | /v1/files/{id} | 文件详情 |
| PATCH | /v1/files/{id} | 更新元数据 |
| DELETE | /v1/files/{id} | 删除文件 |
| GET | /v1/files/{id}/download-url | 生成下载URL |
MCP Storage Tool
MCP存储工具
| Tool | Purpose |
|---|---|
| 7_code_examples_data | CRUD + file upload code examples |
| 工具 | 用途 |
|---|---|
| 7_code_examples_data | CRUD及文件上传代码示例 |
Upload Flow (Single File)
单文件上传流程
1. POST /v1/files/presigned-url -> { url, fileId }
2. PUT {url} with file binary + Content-Type header
3. POST /v1/files with { fileId, filename, contentType, size, visibility }1. POST /v1/files/presigned-url -> { url, fileId }
2. PUT {url} with file binary + Content-Type header
3. POST /v1/files with { fileId, filename, contentType, size, visibility }Multipart Upload Flow (Large File)
大文件分片上传流程
1. POST /v1/files/multipart/init -> { uploadId }
2. POST /v1/files/multipart/urls -> [{ partNumber, url }]
3. PUT each part URL with file chunk
4. POST /v1/files/multipart/complete -> { file }1. POST /v1/files/multipart/init -> { uploadId }
2. POST /v1/files/multipart/urls -> [{ partNumber, url }]
3. PUT each part URL with file chunk
4. POST /v1/files/multipart/complete -> { file }Official Documentation (Live Reference)
官方文档（实时参考）
For the latest storage documentation, use WebFetch: