Skip to main content
POST
上传文件

请求体

multipart/form-data
file
file
必填

文件字节内容。

filename
string

上传时显式指定的文件名,覆盖文件部分自身的名称。

Maximum string length: 4096
purpose
enum<string>

处理用途。

可用选项:
file-extract,
image,
video,
batch

响应

上传文件的记录。

上传到调用方项目的文件元数据。

id
string
必填

文件 ID。

Pattern: ^file_[0-9a-hjkmnp-tv-z]{26}$
filename
string
必填

原始文件名(可能带有服务器分配的去重后缀)。

mime_type
string
必填

上传时检测到的 MIME 类型。

size_bytes
integer<int64>
必填

文件大小(字节)。

created_at
string<date-time>
必填

上传时间戳。

extract_status
enum<string>
必填

当前处理状态。

可用选项:
ready,
error
purpose
enum<string>

处理用途。

可用选项:
file-extract,
image,
video,
batch