文件管理 (File)

文件上传与内容提取，支持 PDF、Word、Excel、PPT 等多种格式。上传后可在对话中引用文件内容。

API 端点

POST/files

上传文件

GET/files/{file_id}

获取文件信息

GET/files/{file_id}/content

获取文件内容

DELETE/files/{file_id}

删除文件

请求参数

参数名类型必填说明
filefile必填要上传的文件（PDF、Word、Excel、PPT、TXT 等）
purposestring必填文件用途，设为 'file-extract'

请求示例

请求示例
# 使用 multipart/form-data 上传文件
POST /v1/files
Content-Type: multipart/form-data

file: @document.pdf
purpose: file-extract

响应示例

响应示例
{
  "id": "file-abc123",
  "object": "file",
  "bytes": 12345,
  "created_at": 1677652288,
  "filename": "document.pdf",
  "purpose": "file-extract",
  "status": "processed"
}

代码示例

from openai import OpenAI
from pathlib import Path

client = OpenAI(
    api_key="your-api-key",
    base_url="https://kimi-api.com/v1"
)

# 上传文件
file_object = client.files.create(
    file=Path("document.pdf"),
    purpose="file-extract"
)

# 在对话中引用文件
response = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[
        {
            "role": "system",
            "content": "你是 Kimi，善于分析文档内容"
        },
        {
            "role": "system",
            "content": [
                {"type": "file", "file_id": file_object.id}
            ]
        },
        {
            "role": "user",
            "content": "请总结这篇文档的要点"
        }
    ]
)

print(response.choices[0].message.content)