文件 API

文件 API 用于上传和管理文档，配合模型实现文档解析与问答（如 PDF、Word、图片 OCR）。

支持的端点

端点	说明
POST /files	上传文件
GET /files	列出文件
GET /files/{file_id}	获取文件详情
DELETE /files/{file_id}	删除文件

上传文件

from openai import OpenAI

client = OpenAI(
    api_key="<your api key>",
    base_url="https://yuansuo.top",
)

file = client.files.create(
    file=open("report.pdf", "rb"),
    purpose="file-extract",
)
print(file.id)

文件问答

将 file_id 传入对话消息，模型会解析文件内容后作答：

response = client.chat.completions.create(
    model="SpAk-Aster-V1-MOE",
    messages=[{
        "role": "user",
        "content": [
            {"type": "file", "file": {"file_id": file.id}},
            {"type": "text", "text": "总结这份文件的关键信息"},
        ],
    }],
)
print(response.choices[0].message.content)

注意事项

1. 单个文件不超过 100MB，每个账号最多保存 1000 个文件。
2. 文件解析按页计费，详见模型 & 价格。