上传文件

上传可在多个 API 端点中使用的文件，如对话附件、微调数据集等。

接口信息

HTTP 方法	POST
接口路径	/v1/files
认证	Bearer Token
Content-Type	multipart/form-data

请求参数

参数	类型	必填	说明
file	file	✅	要上传的文件
purpose	string	✅	用途：assistants、vision、batch、fine-tune

请求示例

curl https://api000.com/v1/files \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -F purpose="assistants" \
  -F file="@document.pdf"

from openai import OpenAI

client = OpenAI(
    base_url="https://api000.com/v1",
    api_key="sk-xxxxxxxxxxxxxxxx"
)

with open("document.pdf", "rb") as f:
    result = client.files.create(file=f, purpose="assistants")

print(result.id)  # file-abc123

响应示例

{
  "id": "file-abc123",
  "object": "file",
  "bytes": 123456,
  "created_at": 1677652288,
  "filename": "document.pdf",
  "purpose": "assistants"
}