在 Chat 或 Messages 请求中引用文件、PDF 与多模态内容的完整流程。

典型流程

1. 准备文件内容（本地 base64 编码）
2. POST /chat/completions，messages 中使用 type: "file" + file.file_data
3. （可选）POST /files 上传文件用于存储管理
4. （可选）DELETE /files/:id 清理

API 细节见 文件 与 Chat Completions。

在消息中引用文件

用户消息 content 为数组时，使用 file type，字段嵌套在 file 对象内：

file 字段说明
file_data内联 base64 数据，支持 data:<mime>;base64,... 格式
filename文件名，用于推断 MIME 类型
{
  "role": "user",
  "content": [
    { "type": "text", "text": "总结附件要点" },
    { "type": "file", "file": { "filename": "spec.pdf", "file_data": "data:application/pdf;base64,…" } }
  ]
}

上传限制

  • 默认单文件上限约 32 MB（以网关部署配置为准）。
  • 上传字段名须为 file（multipart），purpose 默认 assistants。
  • 文件与 创建它的 API Key 绑定；换 Key 可能无法访问他人上传的文件。

PDF 预处理（网关扩展）

在 chat 请求体设置 pdf_preprocess：

{
  "pdf_preprocess": {
    "engine": "ocr",
    "max_pages": 20
  }
}
engine说明
native不展开，原样转发
ocrOCR 后送上游
markdown提取 Markdown

Anthropic Messages 同样支持 pdf_preprocess（见 Messages API）。

图片

使用 image_url part，URL 须为 http/https。部分模型不支持视觉模态 — 选模型时参考目录中的 input_modalities。

也可用 file + 内联 base64 传本地图片。

清理与合规

  • 定期 DELETE 不再需要的 file_id。
  • 勿在文件中包含未脱敏的敏感信息；日志中避免记录文件内容。

相关