CHINZY MUSIC

异步音乐创作 API。复用平台 API Key；音乐点数与 Studio 套餐共用，每首成功作品消耗 5 点。API 不使用匿名 IP 免费额度。

1. 提交创作

POST /v1/music/generations
Authorization: Bearer <your-platform-api-key>
Idempotency-Key: <unique-request-id>
Content-Type: application/json

{
  "model": "CHINZY MUSIC",
  "title": "First Light",
  "prompt": "Gentle piano, ethereal female voice, anime ballad",
  "lyrics": "[Verse] Through the night, I hear your voice...",
  "language": "en-ja",
  "quality": "fast"
}

使用同一幂等键重试相同内容不会重复扣点；不同内容返回 409。音乐风格 10–1800 字，歌词 10–3000 字。fast 为 8 步，studio 为 32 步。

2. 查询与下载

GET /v1/music/generations/{id}
GET /v1/music/generations/{id}/audio
Authorization: Bearer <your-platform-api-key>

状态：queued、running、succeeded、review、failed、cancelled。review 表示有音频但需要试听质量提示；失败返还点数。下载需携带同一账号的有效 API Key，返回 MP3。

同一账号最多 3 个待处理任务。队列满返回 429；无在线引擎返回 503，均不扣点。仅使用服务返回的实际状态，不推算虚构进度。

套餐与计费

Pro：$10 / 月，2,500 点；Premier：$30 / 月，10,000 点。年付分别 $96 / $288，每月释放对应点数，不结转。实际人民币结算价由购买确认页展示。钱包购买，到期手动续费。

图片与视频沿用独立按次价格，不使用音乐点数。音乐套餐与点数不替代原平台文本模型的计费方式。

查看音乐套餐