图片生成

按照 快速开始 准备自己的 Key 和预算。下面的独立客户端完成目录检查、询价、精确成本上限、创建、相同请求重放、轮询、下载与费用核对：

python3 uniroute-media.py --key-file ~/.config/uniroute/api-key \
  --budget-usd 0.05 --kind image --verify-idempotency \
  --state ./image-run.json --output ./image-output

示例使用 z-image，mediaKind: "image"，选项 16:9，无需外部图片输入。示例报价为 0.0056 USD，实际以当前询价为准。目录从 GET /v1/media/catalog 的 data.models 获取；modelId 和 param.options[].value 决定请求值。

询价 POST /v1/media/quote：

{"model":"z-image","option":"16:9"}

创建 POST /v1/media/tasks，同时提供唯一的 Idempotency-Key。下面金额仅为示例，必须替换成刚取得的 quoted_usd：

{"media_type":"image","model":"z-image","option":"16:9","prompt":"A quiet mountain lake at sunrise, watercolor illustration.","max_cost_usd":"0.0056"}

返回 HTTP 202 后保存 data.task_id，通过 GET /v1/media/tasks/{task_id} 查询。只有 status: "success" 和 billing.state: "charged" 同时满足后才使用 urls[].url 下载。下载时不要发送 Key。客户端会将文件保存到指定输出目录，并报告实际 charged_usd。

需要修改 prompt 或选项时，先确认目录并重新询价，作为明确的新任务使用新幂等键。确认重放则保持原请求体不变。中断恢复请使用原状态文件，不能把重新创建当作恢复。