首页/AI/AI 应用速查/文件上传与引用(Files API)

文件上传与引用(Files API)

先把文档或数据集上传换取 file_id,再在请求中引用:用于批处理输入、微调数据集与文件检索。上传即数据驻留,注意用途专属性与生命周期管理。

AI 应用速查AI更新于 2026-10-12
用途Batch 输入、微调数据、检索库、文件问答
流程POST /v1/files(purpose 必填)→ 得到 file_id → 请求引用
清理DELETE /v1/files/{id} 删除
限制大小与格式限制以官方文档为准

上传与删除(curl)

上传与删除(curl)
curl -s https://api.openai.com/v1/files -H "Authorization: Bearer $OPENAI_API_KEY" -F purpose=batch -F file=@data.jsonl
curl -s -X DELETE https://api.openai.com/v1/files/FILE_ID -H "Authorization: Bearer $OPENAI_API_KEY"
上传前确认平台的数据保留与删除策略(各家用例不同);敏感数据先脱敏再传,遵守企业合规要求。

易错点

  • purpose 填错导致后续用途校验失败
  • 临时文件不清理,形成数据残留与合规风险

数据来源与参考

  • OpenAI Files API 文档

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌