几分钟内开始使用文件上传 API,支持多种上传方式
欢迎使用文件上传 API#
文件上传 API 为您提供灵活、高效的文件上传服务,支持多种上传方式以满足不同的业务需求。无论是远程文件迁移、大文件传输还是小文件快速上传,我们的 API 都能为您提供最佳解决方案。
Base64 上传
Base64 编码文件上传,适合小文件
URL 文件上传
从远程 URL 自动下载并上传文件文件上传是免费的 - 上传文件到我们的服务不收取任何费用。您可以放心上传文件,无需担心上传成本或费用。
重要提醒:上传文件在上传 24 小时后自动删除。请及时下载或迁移重要文件。
身份验证#
所有 API 请求都需要使用 Bearer 令牌进行身份验证。请从 API 密钥管理页面 获取您的 API 密钥。请妥善保管您的 API 密钥,切勿公开分享。如果怀疑密钥泄露,请立即重置。
API 基础 URL#
https://kieai.redpandaai.co
身份验证请求头#
快速开始指南#
第一步:选择上传方式#
第一步补充:fileName 参数说明#
fileName 参数在所有上传方式中都是可选的,其行为如下:
fileName (string, optional)#
若新上传的文件名与已存在文件名相同,则旧文件将被覆盖
第二步:处理响应结果#
{
"success": true,
"code": 200,
"msg": "文件上传成功",
"data": {
"success": true,
"fileName": "my-image.jpg",
"filePath": "kieai/12345/images/my-image.jpg",
"downloadUrl": "https://tempfile.redpandaai.co/kieai/12345/images/my-image.jpg",
"fileSize": 245760,
"mimeType": "image/jpeg",
"uploadedAt": "2025-01-15T10:30:00.000Z"
}
}
上传方式对比#
实用示例#
批量文件上传#
错误处理#
出错时 HTTP 状态仍为 200,错误码在响应体 code 中。常见错误及处理方法:401 未授权
400 参数错误
500 服务器错误
最佳实践#
文件大小优化
小文件 (≤1MB):推荐使用 Base64 上传
中等文件 (1MB-10MB):推荐使用文件流上传
性能优化
安全考虑
错误处理
文件存储说明#
可以使用 downloadUrl 字段获取直接下载链接
状态码说明#
错误码在响应体 code 中,HTTP 状态为 200。400 (参数错误): 请求参数不正确或缺少必填参数
405 (方法不被允许): 请求方法不支持,请检查HTTP方法
500 (服务器错误): 处理请求时发生意外错误,请重试或联系支持