获取上传授权信息

POST

/api/open/api/v1/upload/prepare

限频：1

每个用户/每个API/每秒钟内请求 1 次，超出频率的请求会被拦截掉。

配额：200 次/天

调用成功才计为 1 次，即：每天可以上传 200 个文件（含图片、音频、PDF等）

限制

类型	文件大小检测	MIME检测
图片	小于 50MB	image/gif image/jpeg image/jpg image/png image/webp
音频	小于 200MB	audio/mpeg audio/mp4 audio/x-m4a audio/m4a audio/mp4a-latm
PDF	小于 100MB	application/pdf application/x-pdf

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{API-KEY}}

Body 参数application/json

fileType

integer

可选

文件类型：必填
1-图片 2-音频 3-PDF

fileName

string

可选

文件名称：选填（未填时，系统生成）

示例

{
    "fileType": 0,
    "fileName": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/open/api/v1/upload/prepare' \
--header 'Authorization: Bearer {{API-KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileType": 0,
    "fileName": "string"
}'

返回响应

🟢200成功

application/json

Body

form

object

可选

文件上传表单（后续上传时，需要使用此表单）

额外字段

string

可选

示例

{
    "form": {
        "property1": "string",
        "property2": "string"
    }
}

🔴500服务器错误

修改于 2025-06-13 03:31:40

说明

文件投递示例