跳转到主要内容
POST
/
api
/
open-api
/
v1
/
files
/
upload
Upload File
curl --request POST \
  --url https://www.jimmyai.cn/api/open-api/v1/files/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "url": "https://cdn.example.com/openapi/upload/20240628/abc123.jpg",
    "filename": "photo.jpg",
    "size": 102400,
    "mime_type": "image/jpeg"
  }
}
将图片、视频或音频文件上传至服务器，获取可公网访问的 URL，用于视频生成、图片编辑等接口的参考素材。
单文件大小不超过 100 MB。字段名固定为 file，使用 multipart/form-data 格式。

​
支持格式

类型扩展名
图片.jpg .jpeg .png .gif .webp .bmp .svg
视频.mp4 .mov .avi .webm .mkv .m4v .flv
音频.mp3 .wav .aac .m4a .flac .ogg

​
使用场景

返回的 url 可直接用于其他 OpenAPI 接口，例如：

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

multipart/form-data
​
file
file
必填

File to upload. Field name must be file.

响应

200 - application/json

Upload successful

​
code
integer
示例:

20000

​
msg
string
示例:

"ok"

​
data
object
示例:
{
  "url": "https://cdn.example.com/openapi/upload/20240628/abc123.jpg",
  "filename": "photo.jpg",
  "size": 102400,
  "mime_type": "image/jpeg"
}