テキストから音声を設計し、候補を試聴して 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 には別の冪等性キーが必要です。