OpenAI 兼容文件 API，用于上传并在 对话 中通过 file_id 引用。

Base：https://51kik.com/v1/files

认证

所有操作均需 Authorization: Bearer YOUR_API_KEY。文件与创建时使用的 Key 绑定。

端点

方法路径说明
POST/filesmultipart 上传
GET/files列表（当前 Key 下）
GET/files/:id元数据
DELETE/files/:id删除
GET/files/:id/content下载二进制内容

上传

curl -sS "https://51kik.com/v1/files" \
  -H "Authorization: Bearer $API_KEY" \
  -F "purpose=assistants" \
  -F "file=@./document.pdf"
字段说明
file必填，multipart 文件字段名须为 file
purpose可选，默认 assistants

成功 200 响应示例：

{
  "id": "file-xxxxxxxx",
  "object": "file",
  "bytes": 12345,
  "created_at": 1710000000,
  "filename": "document.pdf",
  "purpose": "assistants"
}

单文件大小上限默认约 32 MB（部署配置为准）。

列表

curl -sS "https://51kik.com/v1/files" \
  -H "Authorization: Bearer $API_KEY"

返回 { "object": "list", "data": [ ... ] }。可选查询 limit（1–10000，默认上限较大）。

获取元数据 / 删除 / 下载

curl -sS "https://51kik.com/v1/files/FILE_ID" -H "Authorization: Bearer $API_KEY"
curl -sS -X DELETE "https://51kik.com/v1/files/FILE_ID" -H "Authorization: Bearer $API_KEY"
curl -sS "https://51kik.com/v1/files/FILE_ID/content" -H "Authorization: Bearer $API_KEY" -o out.bin

在对话中使用

见 文件与上下文。

SDK

await client.files.upload({ file: buffer, filename: "a.pdf", purpose: "assistants" });
await client.files.list();

见 SDK 文件与模型。