---
title: "上传文件-文件管理API-API黄页 | 万维易源"
canonical_url: "https://www.showapi.com/playground/minimax/hailuo/conch-ai-file"
last_updated: "2026-09-02T20:14:02.965Z"
meta:
  description: MiniMax海螺文件管理API提供高效文件上传接口，支持知识库检索与finetune功能，助力文档处理与数据整合。
  keywords: 文件管理API，知识库检索，文件上传接口，海螺API，MiniMax文档上传
  "og:description": MiniMax海螺文件管理API提供高效文件上传接口，支持知识库检索与finetune功能，助力文档处理与数据整合。
  "og:title": 上传文件-文件管理API-API黄页
---

*

*

*

# **文件管理API**

[MiniMax-海螺](https://www.showapi.com/playground/minimax/hailuo) [** 产品首页](https://platform.minimaxi.com/document/file) [**API文档](https://platform.minimaxi.com/document/file) [**应用示例](https://www.showapi.com/aiapp/minimax/hailuo/conch-ai-file.html)

**9305

2025-05-12更新

**159 [提交收录](https://www.showapi.com/island/feedback-page?submitrequire=true) [反馈问题](https://www.showapi.com/island/feedback-page?apiurl=/playground/minimax/hailuo/conch-ai-file) [ 创建我的API](https://www.showapi.com/playground)

文件管理API允许用户上传文件，支持pdf、docx、txt、jsonl等格式，用于知识库检索、模型finetune等用途。API还支持列出、检索、删除和下载文件，提供文件大小、创建时间、文件名等信息。

**基础配置**

**Api\_key****\*****[去获取Api\_key](https://platform.minimaxi.com/user-center/basic-information/interface-key)

API\_key，可在账户管理>接口密钥中查看。

选择接入点：

**POST**

**

**Run

**接入点文档：**[查看](https://platform.minimaxi.com/document/file)

Run: Ctrl+

↵

接入点描述：该接口用于上传可以与知识库检索、finetune等功能一起使用的文档。

**请求参数**

**GroupId****\***

用户所属的组，该值应拼接在调用API的url末尾。

**file****\***

需要上传的文件。

**

拖动文件到此，或点击上传

**purpose****\***

文件使用目的。取值及支持格式如下：1. retrieval：知识库检索，（支持pdf、docx、txt格式的文档）；2. fine-tune：模型finetune，（支持jsonl格式的文件）；3. fine-tune-result：模型finetune训练结果；4. voice\_clone：快速复刻原始文件，（支持mp3、m4a、wav格式）；5. prompt\_audio: 音色复刻的示例音频，（支持mp3、m4a、wav格式）；6. assistants：助手，（支持文件格式请参考【Assistants-操作指南】中【支持文件类型】列表了解详情）；7. role-recognition：文本角色分类，（支持txt、json格式的文档；需要注意的是，即使上传的是txt文本，txt文本的正文也需要是json格式）；8. t2a\_async\_input：异步超长文本语音生成传入合成文本文件。

**

**返回结果**

当前为示例返回

**

返回体

返回头

**使用其他软件测试API**

您可以拷贝Curl语句，直接导入Postman进行测试

**拷贝Curl语句