临时媒体上传
将图片、视频和音频输入临时中转到 PixMind R2，并随生成任务自动清理。
图生图、图生视频、首尾帧和参考媒体请求建议使用临时上传。它适合本地文件，也适合可能响应慢、需要权限或拦截模型供应商机房 IP 的第三方链接。
1. 申请预签名上传地址
提交准确的文件名、MIME 类型和字节数。单文件最大 200 MB。
FILE="./first-frame.png"
LEASE=$(curl https://aihub-admin.aimix.pro/api-platform/v1/files/presign \
-H "Authorization: Bearer $PIXMIND_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"first-frame.png\",\"contentType\":\"image/png\",\"fileSize\":$(wc -c < \"$FILE\")}")
UPLOAD_URL=$(echo "$LEASE" | jq -r '.data.uploadUrl')
FILE_URL=$(echo "$LEASE" | jq -r '.data.fileUrl')
UPLOAD_ID=$(echo "$LEASE" | jq -r '.data.uploadId')上传地址有效期为 15 分钟。生成接口需要使用返回的 fileUrl。
2. PUT 文件内容
Content-Type 必须与申请上传地址时填写的值一致。
curl -X PUT "$UPLOAD_URL" \
-H "Content-Type: image/png" \
--data-binary "@$FILE"3. 创建生成任务
将 fileUrl 放入对应媒体字段。建议同时传入 temporaryUploadIds 进行明确的归属校验；接口也会自动识别请求中的临时 URL。
curl https://aihub-admin.aimix.pro/api-platform/v1/generations \
-H "Authorization: Bearer $PIXMIND_API_KEY" \
-H "Content-Type: application/json" \
-d "{
\"type\": \"video\",
\"model\": \"minimax-h3\",
\"prompt\": \"电影感缓慢推镜\",
\"firstFrameUrl\": \"$FILE_URL\",
\"temporaryUploadIds\": [$UPLOAD_ID],
\"duration\": 5,
\"resolution\": \"1080p\"
}"生命周期与限制
- 临时上传只能绑定一个生成任务，并且必须属于当前 API Key 对应的用户和应用。
- 创建任务前，PixMind 会检查对象是否存在，并核对实际大小与
fileSize是否一致。 - 任务变为
ready或failed后，R2 对象会自动删除。 - 从未使用的上传会在 24 小时后删除。
- 支持常见
image/*、video/*和audio/*媒体文件。 - 不要把预签名
uploadUrl传给模型，应使用fileUrl。