上传和读取素材

上传输入

POST /assets/input 使用 multipart，查询参数 model 必填。图片、视频和音频按服务合同选择 image、video、audio 字段；通用文件和文档使用 file。不要用 JSON 编码原始二进制。

curl --fail-with-body --max-time 120 \
  "$JUSP_BASE_URL/assets/input?model=$JUSP_MODEL" \
  -H "Authorization: Bearer $JUSP_API_KEY" -F 'image=@reference.png'

示例中的模型别名由平台提供；自己拼接查询参数时应 URL 编码。成功响应读取 asset.assetId，不是顶层 assetId。上传不等于启动模型生成。

保留素材边界

支持格式、字节大小、像素、时长和素材数量由目标模型及模式决定。提交前根据模型详情校验；不得通过改扩展名绕过格式限制。

输入素材通常是临时资源，应读取响应的有效期，不把它当永久文件仓库。API 上传素材与 Portal“我的资源”上传列表不等价；不要假定任何可见资源 ID 都能跨模型、跨身份使用。

H3 全能参考中的音频使用 audio 字段；包含音轨的 MOV 作为音频参考时同样按音频身份上传，不消耗视频参考名额。上传身份不保证任意编码都可解码。

下载生成结果

任务成功后优先读取 outputs[].contentUrl，携带创建任务的同一 API Key。下载前可用对应 HEAD 操作检查元信息。不要拼接对象存储地址，不要将带鉴权的信息转发到不可信 Host。

生产客户端应校验响应 URL 与可信 API 基础地址同源，限制重定向，设置读超时和最大文件预算。示例中的链接不是匿名永久分享地址。

异步任务与下载 · GET 素材内容。