任务
ModelPort API 文档
使用说明
提交、查询与取消媒体生成任务。
将 max_price_usd 替换为你接受的费用上限。每个新任务使用唯一幂等键，重试相同任务复用原键。
提交已报价任务
curl "https://apimodel.store/v1/jobs" \
-H "Authorization: Bearer $MODELPORT_API_KEY" \
-H "Idempotency-Key: image-example-01" \
-H "Content-Type: application/json" \
--data '{"model":"nano-banana-2-1","prompt":"A ceramic cup in morning light.","parameters":{"resolution":"1K"},"max_price_usd":"0.05"}'查询任务状态
curl "https://apimodel.store/v1/jobs/$MODELPORT_JOB_ID" \ -H "Authorization: Bearer $MODELPORT_API_KEY"
申请取消
curl -X POST "https://apimodel.store/v1/jobs/$MODELPORT_JOB_ID/cancel" \ -H "Authorization: Bearer $MODELPORT_API_KEY"
生成结果位于 files[].url。对下载地址发出携带 API 密钥的 GET 请求。若要让浏览器保存文件，在地址后加上 ?download=1。取消结果以任务状态和账单为准。
为生成结果创建临时下载链接
curl "https://api.apimodel.store/v1/jobs/$MODELPORT_JOB_ID/download-links" \
-H "Authorization: Bearer $MODELPORT_API_KEY" \
-H "Content-Type: application/json" \
--data '{"expires_in":900}'任务完成后可创建临时链接。持有返回的 files[].url 即可在有效期内下载。链接默认有效 15 分钟，最多 24 小时，且以原文件保留期限为上限。expires_at 为 Unix 毫秒时间戳。
生成文件自任务完成起保存 30 天。files_expires_at 是下载截止时间（Unix 毫秒）。到期后 files_expired 为 true，旧下载地址返回 410 output_expired，任务状态和账单仍可查询。
失败或核查中的媒体任务返回 failure，包含 code、category、message、retryable。reconcile 状态请继续查询原任务编号。