텍스트 설명으로 음색을 만들고 후보를 미리 들은 뒤 TTS 음색으로 저장합니다.

음색 디자인

두 단계로 처리됩니다. 먼저 임시 디자인과 후보를 만든 다음 후보 하나를 저장하여 영구 voiceId를 받습니다.

POST /api/open/v1/voice-designs
Authorization: Bearer FISHAUDIO_API_KEY
Idempotency-Key: unique-preview-request

응답에는 designId, candidateId, 보호된 미리 듣기 URL이 포함됩니다. 오디오 요청에도 같은 Bearer 키가 필요합니다.

POST /api/open/v1/voice-designs/{designId}/voices
Authorization: Bearer FISHAUDIO_API_KEY
Idempotency-Key: unique-save-request

candidateId, 이름, 공개 범위를 전송합니다. 반환된 voiceId를 TTS에 사용하세요. 각 POST 요청에는 서로 다른 멱등성 키가 필요합니다.