テキスト読み上げ (HTTP) (HTTP)

音声モデル ID とエンジン設定を使った REST 音声合成。

テキスト読み上げ (HTTP)

エンドポイント

POST /api/open/v1/speech/tts

リクエストヘッダー

// リクエストパラメータ
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY  // API キー

// リクエストパラメータ
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_KEY  // API キー

リクエストパラメータ

サンプルリクエストパラメータ

利用可能なオプション:

• テキスト読み上げ (HTTP): v1, v2, s1
• テキスト読み上げ (HTTP v2): v3-turbo, v3-hd
• 任意: 音声 ID と任意のエンジン設定で音声を合成します。

レスポンスデータ

// レスポンスデータ (cache=false) - 200
Content-Type: audio/mpeg
<複数形式>

// レスポンスデータ (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // レスポンスデータ
  "audio_url": string,       // 音声テキスト化
  "format": string,          // 複数形式
  "characters_used": number, // リクエストパラメータ
  "quota_remaining": number  // API 残量と基本アカウント情報を確認します。
}

// 照会に失敗しました
{
  "error": string     // 照会に失敗しました
}

CURL 例

# リクエストパラメータ - 任意
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "fishaudio-s21pro-flash",
    "text": "音声テキスト化",
    "speed": 1.0,
    "volume": 0,
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# リクエストパラメータ - 利用可能なオプション:
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "minimax-2.8-hd",
    "text": "音声テキスト化",
    "speed": 1.0,
    "volume": 0,
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# リクエストパラメータ (undefined)

オンラインデバッグ

API キー

リクエスト形式

JSONMessagePack

ステータスコード

200: 成功
400: 不正なリクエスト
401: 未認証
403: アクセス拒否
404: 見つかりません
429: リクエスト過多
500: サーバーエラー