#媒体上传 URL

托管工具与生成任务需要「HTTP(S) URL」形态的媒体引用(media_references 校验 http(s),1009 错误码兜底)。把本地文件变成可引用 URL 的两条路径:

#直传示例

# 1. 申请上传 URL
curl "https://rcn.reelway.ai/v1/image/uploadUrl?type=referenceImage&jobId=$JOB_ID&contentType=image/png" \
  -H "api-key: $REELWAY_API_KEY"

# 2. PUT 文件体(原样携带 uploadHeaders)
curl -X PUT "$UPLOAD_URL" -H "Content-Type: image/png" --data-binary @ref.png

槽位枚举(image 侧):preview、complete、startingImage、cnImage、contextImage1..16、keyframeImage1..8、referenceImage、referenceImageEnd、referenceMask;media 侧:referenceAudio、referenceVideo。细节见媒体与图像 URL。

#资产库四步

prepare 按 sha256 去重(同文件直接 reused: true 跳过上传),finalize 复验哈希与大小后置 ready,bind 把资产绑定到项目槽位;配额见媒体工具。

#错误速查