上传文件

上传一个文件到文件服务

请求地址

POST https://api.stepfun.com/v1/files

请求体

• purpose string required
  文件上传的意图，支持 file-extract 和 retrieval 两种类型；

  • file-extract: 用于提取文件内容
  • retrieval 用于文件存储
  • storage 用于图片理解、视频理解、音色克隆等功能。

• file File optional
  用于上传的文件。限制单个用户上传文件 1000 个；当传入 url 时，可不传入此字段。

  file-extract 和 retrieval 支持的文件格式,文件大小限制为 64M；

  • 纯文本（.txt,.md）
  • PDF(.pdf)
  • Word（doc,docx）
  • Excel（xls,xlsx）
  • PPT(ppt,pptx)
  • CSV(.csv)
  • HTML/XML(.html,.htm,.xml)

  storage 支持的文件格式,文件大小限制为 128M；

  • 视频（mp4）
  • 图片（jpg/jpeg、png、webp、静态gif）
  • 音频文件（mp3、wav）

• url string optional
  远程文件的 URL ，支持 文件格式等同于 file 字段支持的文件格式；同时传 file 和 url 字段，取 file 字段内容。

请求响应

返回单个File 对象

示例

from openai import OpenAI
 
client = OpenAI(api_key="STEP_API_KEY", base_url="https://api.stepfun.com/v1")
 
client.files.create(
file=open("salesOverview.pdf", "rb"),
purpose="file-extract"
)

{
    "id": "file-abc123",
    "object": "file",
    "bytes": 140,
    "created_at": 1613779121,
    "filename": "salesOverview.pdf",
    "purpose": "file-extract",
    "status":"processed"
}