临时文件上传

将文件上传到当前 API Key 对应用户的专属空间。需实名认证。免费额度默认 100MB;超出部分按每 10MB = 1 算力在上传时扣费。

服务正常 免费 文件类 2026-09-20
24-hour status
调用权限
正常
请求频率限制
10次/秒 (10 QPS)
免费额度
无
参考价格
免费
1

填写参数

登录后会自动带上你的请求密钥。去登录

2

返回结果

填写参数后发送请求,结果会显示在这里。

请求预览

在线调试

本工具支持 API 接口的实时请求测试,实时返回接口响应结果,助力开发者快速排查接口问题。
⚠️ 本工具为真实请求,将消耗额度 / 产生计费,请勿填写私密信息。
⚠️ 本页面工具将自动添加请求头,无需手动添加。
请求参数
参数名 参数值 操作

计费说明

请求限制:

免费/测试用户请求频率限制 请求频率总限制 每日请求次数总限制
1秒5次 每个免费用户的QPS总限制 1秒10次 每个用户QPS总限制 10000 (次) 每个用户每日请求总次数

其他准入要求:

无

API文档

接口地址: https://xiaoapis.com/api/file/upload

AI Markdown: /model/file/upload.md 供 LLM / Agent 直接读取

返回格式:

请求方式: HTTPPOST

请求示例: curl -X POST "https://xiaoapis.com/api/file/upload?key=你的密钥" -F "file=@/path/to/demo.mp4"

接口说明:

文件与当前密钥用户绑定。免费额度默认 100MB;超出部分按 每 10MB = 1 算力(向上取整),仅对本次上传落入超额的字节计费。算力不足则拒绝上传。

关联:配额查询、文件列表、删除文件

计费示例:

已用 495MB,再传 20MB → 超额约 15MB → 扣 2 算力。

返回示例:

{"code":200,"msg":"上传成功","data":{"file_id":1,"url":"https://xiaoapis.com/upload/user/1/2026/09/20/demo.mp4","path":"/upload/user/1/2026/09/20/demo.mp4","size":1048576,"storage_quota":524288000,"storage_used":1048576,"storage_remain":523239424}}

错误码参照

状态码说明
200上传成功
400参数错误或配额不足
401/403密钥无效

用户反馈

近期反馈0
未登录

请 登录 后反馈

仅需三步即可快速接入

1
注册认证 · 获取密钥

注册开发者账号并完成实名认证,在 控制台 申请专属API密钥(支持多种安全认证策略)。

2
接口调试 · 开发集成

使用平台 在线调试工具 快速验证接口,通过官方API文档完成业务系统的接口集成与联调。

3
生产上线 · 监控运维

在生产环境调用接口,然后在 个人中心 查看调用日志、平台提供弹性配额与故障排查支持。

WeChat support QR code

Scan to add WeChat support