メインコンテンツへスキップ
POST
/
v1
/
audio
/
speech
curl --request POST \
  --url https://api.apimart.ai/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-mini-tts",
    "input": "今日はとても良い天気です。散歩に最適ですね。",
    "voice": "alloy",
    "response_format": "opus",
    "speed": 1.0
  }' \
  --output speech.opus
バイナリオーディオデータストリーム
curl --request POST \
  --url https://api.apimart.ai/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-mini-tts",
    "input": "今日はとても良い天気です。散歩に最適ですね。",
    "voice": "alloy",
    "response_format": "opus",
    "speed": 1.0
  }' \
  --output speech.opus
バイナリオーディオデータストリーム

Authorizations

Authorization
string
required
すべてのAPIはBearer Token認証が必要ですAPI Keyの取得:API Key管理ページ にアクセスしてAPI Keyを取得してくださいリクエストヘッダーに追加:
Authorization: Bearer YOUR_API_KEY

Body

model
string
required
TTSモデル名利用可能なモデル:
  • gpt-4o-mini-tts - GPT-4o Mini TTS モデル(mp3 形式は未対応)
例: "gpt-4o-mini-tts"
input
string
required
音声に変換するテキストコンテンツ最大長: 4096 文字例: "今日はとても良い天気です。散歩に最適ですね。"
voice
string
required
音声の選択利用可能な音声:
  • alloy - ニュートラルでバランスの取れた音声
  • echo - 男性、落ち着いた音声
  • fable - イギリス英語、ナレーション風の音声
  • onyx - 男性、深い音声
  • nova - 女性、活気のある音声
  • shimmer - 女性、優しい音声
例: "alloy"
response_format
string
default:"mp3"
オーディオ出力フォーマットサポートされているフォーマット:
  • mp3 - MP3フォーマット(デフォルト)
  • opus - Opusフォーマット、インターネットストリーミング用
  • aac - AACフォーマット
  • flac - FLACフォーマット、ロスレス圧縮
  • wav - WAVフォーマット、非圧縮
  • pcm - PCMフォーマット、生のオーディオデータ
例: "mp3"
speed
number
default:"1.0"
音声再生速度範囲: 0.25 から 4.0
  • 0.25 - 最も遅い速度(1/4倍速)
  • 1.0 - 通常速度(デフォルト)
  • 4.0 - 最も速い速度(4倍速)
例: 1.0

Response

成功時はバイナリオーディオデータストリームを返します。これは直接オーディオファイルとして保存または再生できます。 エラー時はJSON形式のエラー情報を返します。エラーコード、メッセージ、タイプが含まれます。