---
title: "文件上传"
method: POST
path: "/llm-application/open/v2/application/file_upload"
tags: ["智能体 API（旧）"]
deprecated: true
---

# 文件上传

`POST /llm-application/open/v2/application/file_upload`

## Request

- Base URL: `https://open.bigmodel.cn/api`
- URL: `https://open.bigmodel.cn/api/llm-application/open/v2/application/file_upload`
- Auth: HTTP bearer

> **Deprecated.**

上传文件到智能体（应用），同步返回上传结果。需通过文件解析状态接口获取解析结果。点击 **Try it** 按钮可快速试用。

## Request body `multipart/form-data`

- object
  - `app_id` string, required: 智能体（应用）id
  - `upload_unit_id` string: 上传文件组件id，文本类必须传，对话类临时文件不传
  - `files` string, binary, required: 支持多文件上传，files 字段可重复出现，每个文件单独作为一个 form-data 字段上传。示例：--form 'files=@"/path/to/file1"' --form 'files=@"/path/to/file2"'
  - `conversation_id` string: 对话类型应用上传临时文件时需先通过创建新会话获得会话ID（对话类型上传临时文件时必传，文本类不传）
  - `file_type` integer: 文件类型 1: excel 2: 文档 3: 音频 4: 图片 5: 视频

## Response `200`

请求成功

- ApplicationFileUploadResponse
  - `data` object, required
    - `success_info` ApplicationFileUploadSuccessInfo[], required: 上传成功的文件
      - `file_id` string, required: 文件id
      - `file_name` string, required: 文件名
    - `fail_info` ApplicationFileUploadFailInfo[], required: 上传失败的文件
      - `file_name` string, required: 文件名
      - `fail_reason` string, required: 失败原因
  - `code` integer, required: 响应码，200为成功
  - `message` string, required: 响应信息
  - `timestamp` integer, required: 响应时间戳

## Other responses

- `default`: 请求失败

## Changes

- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/llm-application/open/v2/application/file_upload/post.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)