文件 API

上传文件

上传用于 Batch 任务、智能体 等功能的文件。注意 Try it 功能仅支持小文件上传,实际支持的文件大小请参见下文 purpose 相关说明。点击 Try it 按钮可快速试用。

post/paas/v4/files

Request

  • Base URL
    https://open.bigmodel.cn/api
  • Auth
    HTTP bearer

Request body multipart/form-data

filestring binary required

要上传的文件。

purpose'batch' | 'code-interpreter' | 'agent' | 'voice-clone-input' required

文件的预期用途。 batch:用于批量任务处理,支持 .jsonl 文件格式,,单个文件大小限制为100 MB,文件数不超过 1000 个。Batch指南。 code-interpreter:文件上传给代码沙盒CI使用,支持的格式包括:pdf、docx、doc、xls、xlsx、txt、png、jpg、jpeg、csv,单个文件大小限制为 20M,图片大小不超过5M,文件数不超过 100 个。 agent:用于智能体文件上传,支持的格式包括:pdf、docx、doc、xls、xlsx、txt、png、jpg、jpeg、csv,单个文件大小限制为 20M,图片大小不超过5M,文件数不超过 1000 个。 voice-clone-input: 用于音色克隆功能示例音频文件的上传。支持的格式包括mp3、wav。 user_data: 用户文件的上传。支持的格式包括 pptx,ppt,docx,doc,xlsx,xls,pdf,限制每个用户最多存储 1T 文件。

Response

业务处理成功

idstring

文件标识符

object'file'
bytesinteger

文件大小(字节)

created_atinteger

文件创建的Unix时间戳

filenamestring

文件名

purposestring

文件的预期用途

Changes

No recorded changes to this operation across all 3 revisions of this API.