API Reference

临时文件上传

POST file-upload ID 49

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

POST https://xiaoapis.com/api/file/upload

24小时状态监控

鉴权

请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理创建密钥。

POST https://xiaoapis.com/api/file/upload
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

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	密钥无效

完整控制台文档（含调试台）：/doc/49