---
title: "文件上传接口"
method: POST
path: "/files"
tags: ["Files"]
---

# 文件上传接口

`POST /files`

上传并处理各种格式的文件，支持获取文件URL、内容提取等功能。

## Response `200`

成功响应

- object
  - `uuid` string, uuid, required — 文件唯一ID,可通过该ID获取文件内容
  - `name` string — 文件名称
  - `size` integer — 文件大小
  - `type` string — 文件MIME类型
  - `status` 'pending' | 'reading' | 'processing' | 'failed' | 'done', required — 文件状态: pending（待处理）/reading（读取中）/failed（读取失败）/done（已读取）
  - `md5` string — 文件MD5值
  - `url` string — 文件URL地址
  - `content` string — 文件内容（只有status=done时，才会填充该字段）

## Other responses

- `400` — 请求参数错误
- `401` — 未授权
- `413` — 文件大小超出限制
- `415` — 不支持的文件类型
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)