音乐生成

这是音乐曲目生成，使用 Suno 供应商模型；与语音合成、TTS 不是同一接口用法。按 快速开始 准备 Key 和客户端：

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

示例模型 ai-music-api/generate，目录 mediaKind: "music"，provider 为 Suno，选项 acoustic, folk, warm。这是风格选项，逗号及空格是完整值的一部分。示例单次报价 0.084 USD，当前目录单位为 per_request；实际以询价为准。一次任务可能返回两首曲目，不能按输出数量重复创建或自行乘单价。

POST /v1/media/quote：

{"model":"ai-music-api/generate","option":"acoustic, folk, warm"}

POST /v1/media/tasks，提供 Idempotency-Key，金额使用刚获得的精确报价：

{"media_type":"music","model":"ai-music-api/generate","option":"acoustic, folk, warm","prompt":"An instrumental acoustic folk melody, warm and peaceful, no vocals.","max_cost_usd":"0.084"}

保存 data.task_id。轮询至 status: "success" 且 billing.state: "charged" 后遍历 urls 对象数组，下载全部 urls[].url，不要给音乐 CDN 请求添加 Bearer。客户端自动保存全部输出并报告该任务的实际收费。

音频生成及结算可能比图片慢。等待期间保留状态文件，不另建任务。遇到 released_unknown 先停下，保留原 ID 查询或联系支持；它不能作为“免费失败”的判断。详见 计费与恢复。