能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务；音乐积分扣除当前未启用。
当前可用范围
本页说明 Suno 任务契约。是否可调用取决于部署配置：提交前查询 GET /api/v1/models?modality=music，并检查模型详情的 live_available。文档更新不代表能力已经启用；未启用操作返回 HTTP 503，不创建任务或扣除积分。1. 创建 API Key
- 在控制台 → API Keys 创建密钥，仅在服务端保存。
2. 提交音乐任务
顶层 model 使用 suno_generate，input.model 选择 Suno 版本。下面的自定义模式示例提供歌词和风格。一次提交是一个执行项，通常返回两首歌曲；不传 output_count，也不需要为两首歌曲提交两次。3. 保存任务 ID
受理成功返回 HTTP 200 和 data.task_id，受理不等于生成完成。保存这个 APIstable ID，后续查询同一任务。如果提交超时且无法确认是否受理，不要自动重新提交。4. 查询直到任务结束
将 YOUR_TASK_ID 替换为受理时返回的任务 ID。data.status 为 processing 时，间隔一段时间继续查询；succeeded 或 failed 时停止。失败原因查看 data.message；成功前 result 为 null。5. 读取并保存歌曲
- HTTP 响应只解析一次。response.data.result 已经是对象，不要再次 JSON.parse；只有任务 input 字段仍为 JSON 字符串。
- 歌曲类任务从 response.data.result.data.data 读取歌曲数组。每首包含 id、audio_url、title、lyrics 等元数据；可选封面和流媒体地址可能为 null。
- 歌曲 id 可作为翻唱、续写等操作的 audio_id。所有 ID 均为 APIstable 内部 ID，由服务端映射供应商 ID。翻唱、续写使用已有 audio_id，不接受外部 URL，也不需要源 task_id。
- 生成文件保留 14 天，临时上传保留 24 小时，日志保留 30 天。请在过期前下载产物。音乐积分扣除当前未启用，charged_credits 为 0。