文件上传 API 快速开始

几分钟内开始使用文件上传 API，支持多种上传方式

欢迎使用文件上传 API

文件上传 API 为您提供灵活、高效的文件上传服务，支持多种上传方式以满足不同的业务需求。无论是远程文件迁移、大文件传输还是小文件快速上传，我们的 API 都能为您提供最佳解决方案。

Base64 上传

Base64 编码文件上传，适合小文件

文件流上传

高效的二进制文件流上传，适合大文件

URL 文件上传

从远程 URL 自动下载并上传文件

文件上传是免费的 - 上传文件到我们的服务不收取任何费用。您可以放心上传文件，无需担心上传成本或费用。

重要提醒：上传的文件为临时文件，将在 3天后自动删除。请及时下载或迁移重要文件。

身份验证

所有 API 请求都需要使用 Bearer 令牌进行身份验证。请从 API 密钥管理页面获取您的 API 密钥。

请妥善保管您的 API 密钥，切勿公开分享。如果怀疑密钥泄露，请立即重置。

API 基础 URL

https://kieai.redpandaai.co

身份验证请求头

快速开始指南

第一步：选择上传方式

根据您的需求选择合适的上传方式：

URL 文件上传

文件流上传

Base64 上传

适用于从远程服务器下载并上传文件：

cURL

JavaScript

Python

第一步补充：fileName 参数说明

fileName 参数在所有上传方式中都是可选的，其行为如下：

`fileName` (string, optional)

文件名行为说明：

如不提供文件名，将自动生成随机文件名

若新上传的文件名与已存在文件名相同，则旧文件将被覆盖

由于缓存原因，覆盖文件时此更改可能不会立即生效

示例：

第二步：处理响应结果

成功上传后，您将收到包含文件信息的响应：

{
  "success": true,
  "code": 200,
  "msg": "文件上传成功",
  "data": {
    "fileId": "file_abc123456",
    "fileName": "my-image.jpg",
    "originalName": "sample-image.jpg",
    "fileSize": 245760,
    "mimeType": "image/jpeg",
    "uploadPath": "images",
    "fileUrl": "https://kieai.redpandaai.co/files/images/my-image.jpg",
    "downloadUrl": "https://kieai.redpandaai.co/download/file_abc123456",
    "uploadTime": "2025-01-15T10:30:00Z",
    "expiresAt": "2025-01-18T10:30:00Z"
  }
}

上传方式对比

选择最适合您需求的上传方式：

URL 文件上传

最适合：文件迁移、批量处理

优势：

无需本地文件

自动下载处理

支持远程资源

限制：

需要公开可访问的URL

30秒下载超时

实用示例

批量文件上传

使用文件流上传处理多个文件：

JavaScript

Python

错误处理

常见错误及处理方法：

401 未授权

400 参数错误

500 服务器错误

最佳实践

文件大小优化

小文件 (≤1MB)：推荐使用 Base64 上传

中等文件 (1MB-10MB)：推荐使用文件流上传

大文件 (>10MB)：必须使用文件流上传

远程文件：使用 URL 上传，注意100MB限制

性能优化

实施并发控制，避免同时上传过多文件

对大文件考虑分片上传策略

使用适当的重试机制处理网络问题

监控上传进度并提供用户反馈

安全考虑

妥善保管API密钥，定期轮换

验证文件类型和大小

对敏感文件考虑加密传输

及时下载重要文件，避免3天后删除

错误处理

实施完整的错误处理逻辑

记录上传日志用于问题排查

提供友好的错误提示给用户

对失败的上传提供重试选项

文件存储说明

重要提醒：所有上传的文件均为临时文件，将在上传后 3天自动删除。

文件上传后立即可访问和下载

文件URL在3天内保持有效

系统会在响应中提供 expiresAt 字段表示过期时间

建议在过期前及时下载或迁移重要文件

可以使用 downloadUrl 字段获取直接下载链接

状态码说明

200 (成功): 请求已成功处理，文件上传完成

400 (参数错误): 请求参数不正确或缺少必填参数

401 (未授权): 缺少身份验证凭据或凭据无效

405 (方法不被允许): 请求方法不支持，请检查HTTP方法

500 (服务器错误): 处理请求时发生意外错误，请重试或联系支持

支持

需要帮助吗？我们的技术支持团队随时为您提供帮助。

邮箱: support@kie.ai

文档: docs.kie.ai

API状态: 查看我们的状态页面了解实时API健康状况

文件上传 API 快速开始

欢迎使用文件上传 API#

身份验证#

API 基础 URL#

身份验证请求头#

快速开始指南#

第一步：选择上传方式#

第一步补充：fileName 参数说明#

fileName (string, optional)#

第二步：处理响应结果#

上传方式对比#

实用示例#

批量文件上传#

错误处理#

最佳实践#

文件存储说明#

状态码说明#

支持#

欢迎使用文件上传 API

身份验证

API 基础 URL

身份验证请求头

快速开始指南

第一步：选择上传方式

第一步补充：fileName 参数说明

`fileName` (string, optional)

第二步：处理响应结果

上传方式对比

实用示例

批量文件上传

错误处理

最佳实践

文件存储说明

状态码说明

支持