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

文件流上传

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

功能特点#

支持多种文件类型的二进制流上传
适合大文件上传,传输效率高
自动识别 MIME 类型
支持自定义文件名或自动生成(相同文件名会覆盖旧文件,可能存在缓存延迟)
返回完整的文件信息和下载链接
API Key 认证保护
上传文件为临时文件,3天后自动删除

使用建议#

推荐用于大文件(>10MB)
支持多种格式:图片、视频、文档等
传输效率比 Base64 格式高约 33%

示例命令#

Request

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

Responses

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

🟠400BadRequestError
🟠401UnauthorizedError
🔴500ServerError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/file-stream-upload' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'uploadPath="images/user-uploads"' \
--form 'fileName="my-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
Base64 文件上传
Next
URL 文件上传
Built with