ボイスを一覧表示

システムボイスまたはあなたのクローンボイスを一覧表示します。無料です。

POST/v1/get_voice

voice_type を voice_cloning にするとあなたのクローンボイス、system でシステムボイス、all ですべてを一覧表示します。voice_generation は常に空です。リクエストしなかった種類はレスポンスで null になります。

クローンボイスは、あなたのアカウントでクローンに成功し、削除や期限切れになっていないものだけを一覧表示します。システムボイスはシステムボイスでも直接確認できます。

ボイスを一覧表示

curl https://api.hop-base.com/v1/get_voice \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "voice_cloning"
  }'

200application/json

{
  "system_voice": null,
  "voice_cloning": [
    {
      "voice_id": "MyNarrator01",
      "description": [],
      "created_time": "2026-09-25"
    }
  ],
  "voice_generation": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

ヘッダー

Authorization:必須string

Bearer sk-…：コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

リクエストボディJSON

voice_type:必須string

一覧表示するボイスの種類

取りうる値systemvoice_cloningvoice_generationall

レスポンス

200ボイス一覧

system_voice:任意array of object または null

システムボイス。リクエストしなかった場合は null

voice_cloning:任意array of object または null

あなたのクローンボイス。リクエストしなかった場合は null

voice_generation:任意array of object または null

常に空配列。リクエストしなかった場合は null

base_resp:任意object

成功時は {"status_code": 0, "status_msg": "success"}。エラーはここに入らず、200 以外のステータスコードと error オブジェクトで返されます

エラー

400voice_type must be one of system, voice_cloning, voice_generation, all、または未知のフィールドがある

401キー未指定、キーが無効または期限切れ（missing_api_key / invalid_api_key / api_key_expired）

413リクエストボディが 64 KiB を超えた：request body is too large

503ボイスまたはファイルの登録が一時的に利用できません。しばらくしてから再試行してください（例：voice registry is temporarily unavailable; please retry）

ヘッダー

リクエストボディJSON

レスポンス

エラー

関連ページ