KIE.AI
Chinese
  • English
  • Chinese
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
  1. File Upload API
  • 文件上传 API 快速开始
  • Base64 文件上传
    POST
  • 文件流上传
    POST
  • URL 文件上传
    POST
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
MarketVeo3.1 APISuno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload API
Common API
  1. File Upload API

URL 文件上传

POST
/api/file-url-upload
上传的文件为临时文件,3天后自动删除。

功能特点#

支持 HTTP 和 HTTPS 文件链接
自动下载远程文件并上传
自动从 URL 提取文件名或使用自定义文件名(相同文件名会覆盖旧文件,可能存在缓存延迟)
自动识别 MIME 类型
返回完整的文件信息和下载链接
API Key 认证保护
上传文件为临时文件,3天后自动删除

支持的协议#

HTTP:http://example.com/file.jpg
HTTPS:https://example.com/file.jpg

使用场景#

从其他服务迁移文件
批量下载和存储网络资源
备份远程文件
缓存外部资源

重要说明#

确保提供的 URL 可公开访问
下载超时时间为 30 秒
推荐文件大小上限为 100MB

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200SuccessResponse
application/json
文件上传成功
Body

🟠400BadRequestError
🟠401UnauthorizedError
🔴500ServerError
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.kie.ai/api/file-url-upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileUrl": "https://example.com/images/sample.jpg",
    "uploadPath": "images/downloaded",
    "fileName": "my-downloaded-image.jpg"
}'
Response Response Example
200 - 成功示例
{"success":true,"code":200,"msg":"文件上传成功","data":{"fileName":"uploaded-image.png","filePath":"images/user-uploads/uploaded-image.png","downloadUrl":"https://tempfile.redpandaai.co/xxx/images/user-uploads/uploaded-image.png","fileSize":154832,"mimeType":"image/png","uploadedAt":"2025-01-01T12:00:00.000Z"}}
Previous
文件流上传
Built with