文件上传

参考图、音频、视频和文档要先上传到秒做，拿到文件地址后再填进模型参数。上传不扣点。

上传文件

POSThttps://api.miaozuo.cn/v1/files

两种方式任选其一：

方式	请求	说明
上传本地文件	`multipart/form-data`，字段名 `file`	单个文件不超过 200MB
提供文件地址	`application/json`，`{"url": "https://…"}`	地址必须能从公网直接访问（不能是内网地址），由秒做下载后保存

支持的类型：图片（PNG、JPG、WebP、GIF）、视频（MP4、MOV、WebM 等）、音频（MP3、WAV、M4A 等）和文档（PDF、Word、TXT、Markdown）。

# 方式一：multipart 上传本地文件（字段名 file，单个不超过 200MB）
curl https://api.miaozuo.cn/v1/files \
  -H "Authorization: Bearer $MIAOZUO_API_KEY" \
  -F "file=@./product.png"

# 方式二：JSON 传一个可公开访问的地址，由秒做下载
curl https://api.miaozuo.cn/v1/files \
  -H "Authorization: Bearer $MIAOZUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://<你的域名>/images/product.png"}'

返回示例

{
  "id": "file_43",
  "object": "file",
  "url": "https://api.miaozuo.cn/upload/202610/31e23bd8111c74fee90644f4c5025146.png",
  "type": "image",
  "mime_type": "image/png",
  "size": 70,
  "width": 1,
  "height": 1,
  "duration": null,
  "moderation": "passed",
  "created_at": "2026-10-09T17:06:01+08:00",
  "expires_at": "2026-11-08T17:06:01+08:00"
}

字段	说明
`id`	文件编号，形如 `file_43`
`url`	秒做的文件地址，填进模型参数里的图片 / 音频 / 视频 / 文档字段（参数表里类型为 uri 的字段）
`type`	`image` / `video` / `audio` / `file`（文档）
`mime_type` / `size`	文件类型与大小（字节）
`width` / `height` / `duration`	图片、视频的宽高，音视频的时长（秒）；不适用时为 `null`
`moderation`	内容审核状态：`passed`（通过）、`pending` / `reviewing`（审核中）、`rejected`（未通过）
`created_at` / `expires_at`	上传时间与到期时间。到期后文件删除、地址失效，请在到期前使用

内容审核

图片在上传时同步审核，未通过时返回 422 content_rejected，文件不保存。
音频、视频可能在后台继续审核，返回时 moderation 为 pending 或 reviewing。

常见错误

HTTP	code	场景
422	`invalid_params`	没有 `file` 也没有 `url`、文件超过 200MB、类型不支持、地址不可用
422	`content_rejected`	素材未通过内容安全审核
401	`unauthorized`	Key 无效