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 키로 MP3를 다운로드합니다.

계정당 대기 작업은 최대 3개입니다. 대기열이 가득 차면 429, 온라인 엔진이 없으면 503이며 차감하지 않습니다. 추정 진행률 대신 반환된 상태를 사용하세요.

요금제 및 과금

Pro: 월 $10, 2,500포인트. Premier: 월 $30, 10,000포인트. 연간 $96 / $288이며 매월 포인트 지급, 이월 불가. 위안화 합계는 구매 확인 시 표시됩니다. 지갑 구매 및 수동 갱신입니다.

이미지·영상은 별도 건별 요금이며 음악 포인트를 쓰지 않습니다. 음악 요금제는 텍스트 모델 과금을 대체하지 않습니다.