リファレンス音声をアップロードし、カスタム音声を作成します。

音声クローン作成

POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-data

完全な URL:

https://fishaudio.org/api/open/v1/voices

音声の作成には、リファレンスオーディオと FishAudio の作成フローが使用されます。 Open API ルートはプロバイダーのオーバーライドを無視するため、provider フィールドを送信する必要はありません。

リクエストフィールド

フィールド	タイプ	必須	説明
`name`	文字列	はい	音声名
`audioFiles`	ファイル[]	はい	1 つ以上のリファレンスオーディオファイル
`description`	文字列	いいえ	音声解説
`referenceText`	文字列	いいえ	参考音声のトランスクリプト
`visibility`	文字列	いいえ	`private` または `public`。デフォルト: `private`
`languages`	文字列	いいえ	JSON 文字列配列 (例: `'["zh","en"]'`

サポートされているファイル拡張子: aac、flac、m4a、mp3、mp4、mpeg、oga、ogg、opus、wav、webm。各ファイルは最大 10MB まで可能です。

マルチパート境界を手動で設定しないでください。 curl -F、ブラウザ FormData、または SDK を使用する場合、クライアントに Content-Type を生成させます。

curl の例

curl -X POST "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -F "name=My cloned voice" \
  -F "description=Chinese narration voice" \
  -F "visibility=private" \
  -F 'languages=["zh"]' \
  -F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
  -F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"

＃＃応答

{
  "voiceId": "voice_abc123",
  "title": "My cloned voice",
  "description": "Chinese narration voice",
  "createdAt": "2026-07-09T00:00:00.000Z"
}

返された voiceId を保存し、音声を生成するときに直接渡します。

エラー

ステータス	意味
`400`	フィールドが欠落している、サポートされていないファイルタイプ、またはサイズが大きすぎるファイル
`401`	API キーが見つからないか無効です。
`403`	アカウントは音声を作成できません
`429`	音声作成リクエストが多すぎます
`500`	サーバー上で音声の作成に失敗しました

音声を作成すると、Open API の使用量が記録され、現在のアカウントの Open API クォータとプロバイダーの割り当ての影響を受けます。

音声クローン作成

音声クローン作成

リクエストフィールド

curl の例

エラー

このページ