現在の API キーで利用できるパブリックボイスと個人ボイスをリストします。

ボイスをリストする

GET /api/open/v1/voices

完全な URL:

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

ヘッダー

Authorization: Bearer FISHAUDIO_API_KEY

音声のリストは読み取り専用です。タスクの作成やクレジットの消費はありません。

クエリオプション

エンドポイントは、URL クエリパラメーターからオプションのフィルターを読み取ります。それらを省略すると、API は公開の声の最初のページを返します。

フィールド	タイプ	必須	説明
`page`	整数	いいえ	ページ番号。デフォルト: `1`
`pageSize`	整数	いいえ	ページごとの項目。デフォルト: `20`、最大: `100`
`modelType`	文字列	いいえ	`public`、`personal`、または `all`
`includePersonal`	ブール値	いいえ	`true` の場合、デフォルトのモデルタイプは `all` になります。

＃＃応答

{
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "items": [
    {
      "voiceId": "voice_123",
      "title": "Clara",
      "description": "",
      "created_at": "2026-07-09T00:00:00.000Z",
      "updated_at": "2026-07-09T00:00:00.000Z",
      "isPersonal": false
    }
  ]
}

TTS リクエストでは items[].voiceId を使用します。

クイックテスト音声

応答から音声を選択する前に TTS をテストするには、次のパブリックシステム音声 ID を使用します。

00a1b221-6137-4b73-ad62-b0cbce134167

プロダクション音声を選択する準備ができたら、これを items[].voiceId 値に置き換えます。

curl の例

curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

エラー

ステータス	意味
`401`	API キーが見つからないか無効です。
`403`	アカウントは音声をリストできません
`500`	音声カタログのクエリが失敗しました

ボイスをリストする

ボイスをリストする

ヘッダー

クエリオプション

クイックテスト音声

curl の例

エラー

このページ