OpenAI TTS API
低レイテンシまたは高品質のテキスト読み上げに対応し、RunAPIで管理されたMP3を返すOpenAI TTS APIにアクセスできます。
curl -X POST https://runapi.ai/api/v1/openai_tts/text_to_speech \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"text": "この製品オンボーディング用スクリプトを、アプリ内ガイドで使う明瞭で自然な音声に変換してください。"
}'import { OpenaiTtsClient } from "@runapi.ai/openai-tts";
const client = new OpenaiTtsClient();
const result = await client.textToSpeech.run({
model: "tts-1-hd",
text: "この製品オンボーディング用スクリプトを、アプリ内ガイドで使う明瞭で自然な音声に変換してください。",
});require "runapi/openai_tts"
client = RunApi::OpenaiTts::Client.new
result = client.text_to_speech.run(
model: "tts-1-hd",
text: "この製品オンボーディング用スクリプトを、アプリ内ガイドで使う明瞭で自然な音声に変換してください。"
)npx skills add runapi-ai/openai-tts -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorOpenAI TTSは、同期型のRunAPIエンドポイントを通じてテキストを音声に変換します。レイテンシが重要なアプリケーションにはtts-1を、より高音質なナレーションにはtts-1-hdを選択してください。どちらもRunAPIで管理されたMP3 URLを返します。
- 品質とレイテンシ目標に合わせたモデルバリアント
- 統合 API key
- Model skill に docs、schema、セットアップメモを同梱
- 失敗した生成は課金されません
バリアント
アプリ開発用に OpenAI TTS skill をインストール
モデル docs、schema、料金メモ、セットアップ手順をコード作業環境に読み込みます。
# Install the model skill for app development workflows
npx skills add runapi-ai/openai-tts -gInstall the OpenAI TTS skill for this app: 1. Add runapi-ai/openai-tts with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
この model skill で構築する方法
モデルを選ぶ
出力タイプ、品質基準、レイテンシ目標に合うモデルとバリアントを選びます。
一度だけ認証
対応するすべてのモデルに RunAPI key を使います。
skill をインストール
機能実装の前に model skill をコード作業環境へ追加します。
出力を受け取る
task ID でポーリングするか、生成完了時の callback を処理します。
OpenAI TTS の位置づけ
OpenAI TTSは、インタラクティブな再生と完成度の高いナレーションに特化したテキスト読み上げモデルを提供します。RunAPI経由では、両モデルが共通のリクエスト形式を使い、RunAPIが管理する音声のメタデータを返します。
RunAPI 経由で OpenAI TTS を使う理由
1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
Skill-ready
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
予測しやすい請求
呼び出し前に従量料金を確認できます。
よくある質問
tts-1とtts-1-hdの違いは何ですか？
tts-1はインタラクティブな再生に適した低レイテンシを優先し、tts-1-hdはナレーションや完成コンテンツに適した高音質を優先します。
OpenAI TTSはどの音声形式を返しますか？
どちらのモデルもMP3音声を返し、RunAPIのレスポンスには形式、MIMEタイプ、バイト数のメタデータが含まれます。
生成された音声はRunAPIでホストされますか？
はい。RunAPIは音声を検証し、一時的な配信元URLを公開せずに、RunAPIで管理されたURLを返します。
独自の音声や話速を選べますか？
現在公開されているエンドポイントでは、デフォルトの音声と話速を使用します。音声と話速を個別に指定する機能は、このエンドポイントの仕様には含まれていません。
テキスト読み上げは同期処理ですか？
はい。リクエストが成功すると、別のポーリング用エンドポイントを使わずに、生成済みの音声が直接返されます。
このモデルはどう呼び出しますか？
model skill をインストールし、RunAPI key とセットアップメモに従ってください。
失敗した生成は課金されますか？
失敗した生成は課金されません
アプリケーションから呼び出せますか？
はい。コード作業環境に model skill をインストールし、モデル機能を追加するときに利用してください。