本文档由bestai 制作，推荐使用 best ai 文档、API 调试、API Mock、API 自动化测试！

上传资源(视频/音频)

POST

/openapi/v2/media/upload

支持以下mime/type & 后缀
"video/mp4": "mp4",
"video/mov": "mov",
"video/webm": "webm",
"video/quicktime": "mov"
"audio/mpeg": "mp3",
"audio/wav": "wav",
"audio/vnd.wave": "wav",
"audio/x-wav": "wav",
"audio/x-m4a": "m4a",
"audio/aac": "aac",
"audio/x-aac": "aac",
"audio/wave": "wav",
"audio/mp4": "mp3"
2.
视频文件限制
最大分辨率：1920
最大文件大小：50MB
最大时长：30秒
3.
音频文件限制
最大文件大小：50MB
最大时长：30秒

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2/media/upload' \
--header 'API-KEY: {{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'file_url=""'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-05-31 06:32:31

上传图片

图片模版生成接口