跳转到主要内容
文件

上传文件

POST
/files
Python
import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

# 上传文件用于文档解析
file_object = client.files.create(
  file=Path("test.txt"),
  purpose="file-extract"
)
print(file_object.model_dump_json())
{
  "id": "file-fe-xxx",
  "bytes": 2055,
  "created_at": 1729065448,
  "filename": "test.txt",
  "object": "file",
  "purpose": "file-extract",
  "status": "processed",
  "status_details": null
}

鉴权

string
header
必填

千问云 API Key。详见获取 API Key

请求体

multipart/form-data
file
必填

待上传的文件。

enum<string>
必填

文件用途。

  • file-extract:文档解析,最大 150 MB,支持格式:TXT、DOCX、PDF、XLSX、EPUB、MOBI、MD、CSV、JSON、BMP、PNG、JPG/JPEG、GIF、扫描版 PDF。
  • batch:批量处理,最大 500 MB,JSONL 格式(批量文件要求)。
file-extract,batch

响应

200-application/json
string

文件的唯一标识符。

file-fe-xxx
integer

文件大小,单位为字节。

2055
integer

文件创建时间的 Unix 时间戳(秒)。

1729065448
string

上传时的文件名。

test.txt
enum<string>

固定值 file

file
string

文件用途,可选值:batchfile-extractbatch_output

file-extract
string

文件当前状态。

processed
string | null

状态的补充说明,无详细信息时为 null