Skip to main content
POST
上传文件
单个用户最多只能上传 1000 个文件,单文件不超过 100MB,同时所有已上传的文件总和不超过 10G 容量。文件解析服务限时免费,请求高峰期平台可能会有限流策略。
文件接口支持以下格式:.pdf.txt.csv.doc.docx.xls.xlsx.ppt.pptx.md.jpeg.png.bmp.gif.webp.ico.xbm.dib.pjp.tif.pjpeg.avif.dot.apng.epub.tiff.jfif.html.json.mobi.log.go.h.c.cpp.cxx.cc.cs.java.js.css.jsp.php.py.py3.asp.yaml.yml.ini.conf.ts.tsx 等。
上传文件时选择 purpose="file-extract",随后可以让模型获取文件中的信息作为上下文。
showLineNumbers
其中 $MOONSHOT_API_KEY 部分需要替换为您自己的 API Key。或者在调用前给它设置好环境变量。
如果你想一次性上传多个文件,并根据这些文件与 Kimi 对话,你可以参考如下示例:
上传文件时,选择 purpose="image"purpose="video",上传后的图片或视频可以用于模型的原生理解。请参阅使用视觉模型了解完整示例。

授权

Authorization
string
header
必填

Authorization 请求头需要一个 Bearer 令牌。使用 MOONSHOT_API_KEY 作为令牌。这是一个服务端密钥,请在 API 密钥页面 生成。

请求体

multipart/form-data
file
file
必填

要上传的文件

purpose
enum<string>
必填

指定上传文件的处理方式。file-extract:抽取文件内容;image:上传图片,用于视觉理解;video:上传视频,用于视频理解;batch:上传 JSONL 文件,用于批处理任务

可用选项:
file-extract,
image,
video,
batch

响应

已上传文件的元数据

id
string
必填

文件唯一标识符

object
string
必填

对象类型

示例:

"file"

bytes
integer
必填

文件大小(字节)

created_at
integer
必填

文件创建时的 Unix 时间戳

filename
string
必填

原始文件名

purpose
enum<string>
必填

上传文件时指定的用途。file-extract:抽取文件内容;image:上传图片,用于视觉理解;video:上传视频,用于视频理解;batch:上传 JSONL 文件,用于批处理任务

可用选项:
file-extract,
image,
video,
batch
status
string
必填

文件处理状态

示例:

"ready"

status_details
string

处理失败或返回警告时的额外状态详情