生成音乐

POST 
/v1/music

按描述生成一首歌（MP3 文件）。响应为 202，带上排队中的生成；用 GET /v1/music/{music_id} 轮询，直到它变为 completed（此时它的 files 里就是结果）或 failed。发起生成需要项目的计费账户有可用余额，且每个终端用户同时最多有 3 个未完成的生成。

请求

响应

202

成功响应

401

鉴权失败：凭证缺失、格式错误、已过期或已作废。

• invalid_token — 访问令牌无效。
• project_disabled — 此项目未启用。
• token_expired — 访问令牌已过期。
• user_disabled — 此用户未启用。

409

请求与资源的当前状态冲突。

• idempotency_conflict — 这个 Idempotency-Key 属于另一个请求。
• idempotency_in_progress — 带这个 Idempotency-Key 的第一次请求仍在处理中。请稍后用同一个键重试。

413

请求体超过了允许的上限。

• payload_too_large — 请求体太大。

422

请求中的某个值未通过校验；details 数组会列出每个出错的字段。

• validation_failed — 请求内容未通过校验。

429

要么是请求太多（Retry-After 响应头会说明何时重试），要么是计费账户的积分已用完（不带 Retry-After——加上积分才能继续）；用 code 字段区分这两种情况。

• insufficient_credits — 计费账户的积分不足。
• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。