Skip to main content
GET
Get voice details by ID
このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
単一のプリセットボイスについて、サポート言語、スタイル、モデル、事前生成済みサンプル URL を含む完全なボイスオブジェクトを返します。 ユーザーがクローニングしたボイスについては、代わりに カスタムボイス取得 をご利用ください。

エンドポイント

パスパラメータ

レスポンス

ボイスオブジェクトを返します。フィールドごとのリファレンスは Voices をご参照ください。

注意事項

  • アカウント上に voice_id が存在しない場合は 404 Not Found を返します。
  • 明示的な style パラメータなしで TTS を呼び出す前に、このエンドポイントでボイスの デフォルトスタイルstyles の最初の要素)を確認できます。

関連項目

Docs: Voices

ボイスオブジェクトの構造と voice ID の使い方。

List voices

ボイスライブラリ全体を参照します。

Authorizations

x-sup-api-key
string
header
required

Path Parameters

voice_id
string
required

Response

Voice details retrieved successfully

voice_id
string
required

Unique identifier for the voice

Example:

"<voice-id>"

name
string
required

Name of the voice

Example:

"Agatha"

age
string
required

Age of the voice

Example:

"young-adult"

gender
string
required

Gender of the voice

Example:

"female"

use_case
string
required

Use case of the voice

Example:

"narration"

use_cases
string[]
required

Use cases of the voice (array)

Example:
language
string[]
required

Languages supported by the voice

Example:
styles
string[]
required

Styles available for the voice

Example:
models
string[]
required

Models available for the voice

Example:
description
string | null

Description of the voice

Example:

""

samples
object[]

URL to the sample audio file for the voice

thumbnail_image_url
string

URL to the thumbnail image for the voice

Example:

"https://example.com/thumbnails/voice-thumbnail.png"