跳转到主要内容
POST
/
files
文件上传接口
curl --request POST \
  --url https://geekai.co/api/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form purpose=file-url \
  --form format=text
{
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "size": 123,
  "type": "<string>",
  "md5": "<string>",
  "url": "<string>",
  "content": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.geekai.co/llms.txt

Use this file to discover all available pages before exploring further.

极客智坊提供了文件上传与内容提取功能，支持多种文件格式，包括.PDF .DOCX .DOC .XLS .XLSX .PPT .PPTX .PNG .JPG .JPEG .CSV .PY .TXT .MD .BMP .GIF等，你可以通过上传文件接口上传待识别文件，然后通过文件内容提取接口获取文件内容，借助该基础服务，你可以完成AI文件对话/RAG等上层业务场景的功能实现。

​
cURL 请求示例

curl --location --request POST 'https://geekai.co/api/v1/files' \
--header 'Authorization: Bearer {$GEEKAI_API_KEY}' \
--form 'file=@"/E:/文档/geekai/test.pdf"'
--form 'purpose="file-extract"'

​
Postman 请求响应示例

上传文件

授权

​
Authorization
string
header
必填

API认证token

请求体

multipart/form-data
​
file
file
必填

上传的文件，目前支持PDF/DOCX/XLSX/PPTX/PNG/JPG/JPEG/CSV/TXT/MD/MP3/MP4等格式

​
purpose
enum<string>
默认值:file-url

上传目的,目前仅支持获取文件URL、文件内容提取

可用选项:
file-url,
file-extract
​
format
string
默认值:text

返回文件内容格式，目前仅支持文本格式

示例:

"text"

响应

成功响应

​
uuid
string<uuid>
必填

文件唯一ID,可通过该ID获取文件内容

​
status
enum<string>
必填

文件状态: pending（待处理）/reading（读取中）/failed（读取失败）/done（已读取）

可用选项:
pending,
reading,
processing,
failed,
done
​
name
string

文件名称

​
size
integer

文件大小

​
type
string

文件MIME类型

​
md5
string

文件MD5值

​
url
string

文件URL地址

​
content
string

文件内容（只有status=done时，才会填充该字段）