文件上传

ModelPort API 文档

使用说明

POST /v1/files 接收文件字节，返回可用于生成任务的文件 ID。

上传参考图

curl "https://apimodel.store/v1/files" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @reference.png

以表单上传参考图片

curl "https://apimodel.store/api/v1/files" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" -F "file=@reference.png;type=image/png"

申请上传地址

以 JSON 提交 filename、contentType 和可选的 fileSize。data.uploadUrl 与 upload_url 是同一个 10 分钟上传地址。向该地址 PUT 原始文件，保持 Content-Type 一致。填写了 fileSize 时，字节数也须一致。

申请一次性上传地址

curl "https://apimodel.store/api/v1/files" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"filename":"reference.png","contentType":"image/png","fileSize":12345}'

发送文件到上传地址

curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/png" --data-binary @reference.png

在任务中引用文件

{
  "references": [
    {
      "role": "reference_image",
      "file_id": "file_REPLACE_WITH_UPLOAD_ID"
    }
  ]
}

上传后也可把 data.publicUrl 用作图片的 image_url 或 images[]，以及支持对应素材的音视频模型的 image_url、video_url 或 audio_url。该地址仅供当前账户引用和鉴权下载。链接有效期随素材记录，外站地址请先下载并上传。

图片接受 PNG、JPEG、WebP，单文件最多 10 MB。视频接受 MP4、WebM，最多 100 MB。音频接受 MP3、WAV，最多 20 MB。表单只接受一个名为 file 的文件，最多 20 MB，较大的视频请用原始文件上传。文件 ID 仅当前账户可用，有效期见响应的 expires_at。