CHINZY MUSIC

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，每月釋放對應點數，不結轉。實際人民幣結算價由購買確認頁展示。錢包購買，到期手動續費。

圖片與影片沿用獨立按次價格，不使用音樂點數。音樂套餐與點數不替代原平臺文字模型的計費方式。