{"kind":"guides","slug":"text-to-speech-api-docker","path":"/guides/text-to-speech-api-docker","title":"DockerでセルフホストTTS API | SuperClonica","description":"CPUまたはNVIDIA GPU上のDockerで自前の音声合成HTTP APIを動かす方法。サーバーの起動、カスタム音声でのリクエスト、APIキー、スケーリングを解説します。","h1":"Dockerで動かすセルフホスト音声合成API","intro":"自分のサーバー上の音声合成APIは、HTTPリクエストを送れるあらゆるプログラムのためにテキストを音声に変えます。Webサイト、ボット、ゲームのバックエンド、どの言語のスクリプトでも使えます。テキストはマシンの外に出ず、文字数に応じた料金もかかりません。\n\nこのガイドでは、オープンモデルSupertonic 3をベースにしたSuperClonicaエンジンをDockerでHTTPサーバーとして動かす方法を紹介します。CPUまたはNVIDIA GPUでの起動、内蔵音声とカスタム音声でのリクエスト、実運用への準備まで扱います。イメージとエンジンは当社の製品なので、該当する箇所ではそう明記します。","sections":[{"heading":"音声合成を自分で動かす理由","paragraphs":["クラウドの音声APIは手軽に始められますが、リクエストのたびにテキストが提供元に送られ、文字数で課金されます。セルフホストAPIなら、それを自分で管理するサーバーに置き換えられます。"],"points":["プライバシー：テキストと音声は自分のハードウェアにとどまります。社内文書、メッセージ、ユーザーデータでは特に重要です。","コスト：ハードウェアの費用を除けば音声は無料です。長文や大量処理でも請求額は増えません。","どんなクライアントでも：1つのHTTPエンドポイントでPython、JavaScript、Go、PHP、C#、シェルスクリプトに対応できます。","オフライン：モデルを一度ダウンロードすれば、サーバーはインターネット接続を必要としません。"]},{"heading":"サーバーを起動する","paragraphs":["どのCPUでも：docker run -d --name tts -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cpu。NVIDIA GPUでは、NVIDIA Container Toolkitをインストールしてから docker run -d --name tts --gpus all -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cuda を実行します。CUDAとcuDNNはイメージに含まれ、ホストに必要なのはドライバーだけです。","初回起動時にSupertonic 3モデル（約385 MB）がsuperclonica-modelsボリュームにダウンロードされ、次回以降は再利用されます。GET http://localhost:8000/health が状態、バージョン、使用中のデバイスを返せば準備完了です。イメージには独自のヘルスチェックがあるため、docker psで準備ができたかを確認できます。"]},{"heading":"リクエストを送る","paragraphs":["POST /synthesize はJSONを受け取り、16ビット・モノラルのWAVファイルを返します：curl -X POST http://localhost:8000/synthesize -H \"Content-Type: application/json\" -d '{\"text\": \"自分のサーバーからこんにちは。\", \"voice\": \"F1\", \"lang\": \"ja\"}' -o hello.wav。ヘッダーのX-Sample-RateとX-Duration-Secondsが音声の情報を示します。","フィールドはtext、voice、lang、seed、normalizeです。voiceはM1〜M5とF1〜F5の10種類の内蔵音声のいずれか、またはカスタム音声です。langはテキストの言語で、モデルが対応する31言語のいずれかです（中国語は含まれません）。seedを固定すると同じテキストから同じ音声が得られ、normalizeは音量をそろえます。GET /voices は内蔵音声と言語の一覧を返し、/docs では対話型のAPIドキュメントを表示できます。"]},{"heading":"カスタム音声を使う","paragraphs":["Supertonic 3の音声は約0.3 MBのJSONファイルです。音声サンプル付きの無料音声はGitHubのsuperclonica/supertonic-voicesリポジトリにあり、SuperClonicaのカタログには170以上の音声があり、どれも無料のオンラインデモ付きです。","音声はJSONオブジェクトそのものとしてリクエストのvoiceフィールドに入れるため、サーバーは音声ファイルを保持しません。オブジェクトが大きいので、リクエストはファイルに組み立てて curl -d @request.json で送るか、コードからPythonのjson.loadやJavaScriptのJSON.parseで音声を読み込み、テキストと一緒に送信してください。リクエスト本文は最大2 MBです。"]},{"heading":"設定","paragraphs":["サーバーは環境変数から設定を読み込みます。docker runの-eやComposeファイルで指定してください。"],"points":["SUPERCLONICA_API_KEY：設定すると、/synthesize と /voices には Authorization: Bearer とキーのヘッダーが必要になります。","SUPERCLONICA_LANES：モデルのコピー数、1〜8（既定は1）。それぞれが一度に1件のリクエストを処理し、個別にメモリを使います。","SUPERCLONICA_DEVICE：auto、cuda、cpu（既定はauto：GPUがあればGPU）。","SUPERCLONICA_THREADS：CPUスレッド数（既定は物理コアごとに1つ）。","SUPERCLONICA_MAX_TEXT：テキストの最大文字数（既定は5000）。"]},{"heading":"本番運用の前に","paragraphs":["いくつかの習慣で、セルフホストの音声APIを速く安全に保てます。"],"points":["/models ボリュームを残して再起動時にモデルを再ダウンロードしないようにし、コンテナは --restart unless-stopped で起動します。","ポート8000をそのままインターネットに公開しないでください。APIキーを設定し、HTTPS付きのリバースプロキシの背後に置くか、プライベートネットワーク内で使います。","進捗表示やストリーミングが必要なら、長文は自分で段落に分けて送ります。エンジン自体も長文を最大160文字の自然な区切りで読み上げます。","UIのフレーズなど繰り返すテキストの音声はキャッシュしましょう。同じテキスト、音声、seedからは常に同じファイルができます。","自分のハードウェアで計測してください。当社のテストでは、短いフレーズがRTX 5070 Tiで0.12秒、Ryzen 7 5800Xの4スレッドで0.43秒でした。"]},{"heading":"ライセンス","paragraphs":["SuperClonicaエンジンとイメージはApache License 2.0で公開されています。Supertonic 3モデルはOpenRAIL-Mで公開されています。これは非商用条項ではなく禁止用途のリストを持つ、ロイヤリティフリーのライセンスです。同意なく他人になりすます、だます、嫌がらせをする目的で音声を使わず、必要な場面では機械生成の音声であることを明示してください。"]}],"faq":[{"question":"このAPIはOpenAIの音声エンドポイントと互換性がありますか？","answer":"いいえ。独自のシンプルなJSON形式で、text、voice、langといくつかのオプションを送るとWAVファイルが返ります。コードやプロキシに小さなアダプターを置けば、他の形式から変換できます。"},{"question":"GPUは必要ですか？","answer":"いいえ。cpuイメージは一般的なプロセッサーで動き、短いフレーズなら1秒を大きく下回ります。cudaイメージとNVIDIA GPUの組み合わせは数倍速く、大量処理に向いています。"},{"question":"同時にいくつのリクエストを処理できますか？","answer":"リクエストはモデルのコピーであるレーンで処理され、レーンが1つなら順番待ちになります。SUPERCLONICA_LANES（最大8）を設定すると複数を同時に処理できます。CPUではレーンがコアを分け合い、GPUではより有効に活用されます。"},{"question":"インターネットなしで動きますか？","answer":"はい、初回起動後は動きます。モデルは /models ボリュームに保存され、その後サーバーは接続を必要としません。インターネットが必要なのはイメージとモデルのダウンロード時だけです。"}],"cta":{"catalog":"APIで使う音声を見る","install":"エンジンのその他のインストール方法"},"sources":[{"label":"SuperClonicaのDockerイメージ（Docker Hub）","url":"https://hub.docker.com/r/superclonica/superclonica"},{"label":"NVIDIA Container Toolkitのインストール","url":"https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html"},{"label":"SuperClonicaエンジン（PyPI）","url":"https://pypi.org/project/superclonica-cpu/"},{"label":"Supertonic 3モデルカード（Hugging Face）","url":"https://huggingface.co/supertone-oss-archive/supertonic-3"},{"label":"Supertonic 3の無料音声（GitHub）","url":"https://github.com/superclonica/supertonic-voices"}],"published":"2026-10-22","updated":"2026-10-22","pages":[{"slug":"offline-text-to-speech","path":"/guides/offline-text-to-speech","h1":"自分のPCでテキストをオフライン読み上げする方法"},{"slug":"voice-cloning","path":"/guides/voice-cloning","h1":"ボイスクローン：録音の声に近い音声を手に入れる方法"},{"slug":"best-free-tts-models","path":"/guides/best-free-tts-models","h1":"2026年、ローカルで使える無料の音声合成モデル"},{"slug":"text-to-speech-for-videos","path":"/guides/text-to-speech-for-videos","h1":"動画、オーディオブック、ゲーム、アプリのテキスト読み上げ"},{"slug":"supertonic-3-voices","path":"/guides/supertonic-3-voices","h1":"Supertonic 3 の音声：カスタム音声の入手先と使い方"},{"slug":"python-text-to-speech","path":"/guides/python-text-to-speech","h1":"Pythonで音声合成：オフライン・無料・自然な声で"},{"slug":"text-to-speech-api-docker","path":"/guides/text-to-speech-api-docker","h1":"Dockerで動かすセルフホスト音声合成API"}],"related":[{"slug":"text-to-speech","path":"/text-to-speech","h1":"自分のPCで動く音声合成・テキスト読み上げ"},{"slug":"supertonic","path":"/compare/supertonic","h1":"Supertonic と SuperClonica：同じモデルで、より速く、よりクリーンに"},{"slug":"fish-audio","path":"/compare/fish-audio","h1":"Fish Audio・Fish SpeechとSuperClonicaの比較"},{"slug":"omnivoice","path":"/compare/omnivoice","h1":"OmniVoiceとSuperClonica：言語の多さか、速度か"},{"slug":"qwen3-tts","path":"/compare/qwen3-tts","h1":"ローカル音声合成ならQwen3-TTSかSuperClonicaか"},{"slug":"voxcpm","path":"/compare/voxcpm","h1":"VoxCPM 2とSuperClonica：スタジオ品質か、CPUでの速度か"},{"slug":"f5-tts","path":"/compare/f5-tts","h1":"F5-TTSとSuperClonica：ゼロショットのクローンか、CPUでの高速読み上げか"},{"slug":"elevenlabs","path":"/compare/elevenlabs","h1":"オフラインで使えるElevenLabsの代替"},{"slug":"kokoro","path":"/compare/kokoro","h1":"Kokoro TTSとSuperClonica：ローカル音声合成の小型モデル2つ"},{"slug":"piper","path":"/compare/piper","h1":"Piper TTSとSuperClonica：小型デバイスか、オリジナル音声か"},{"slug":"xtts","path":"/compare/xtts","h1":"Coqui XTTS-v2とSuperClonica：Coqui TTSの代替として"},{"slug":"chatterbox","path":"/compare/chatterbox","h1":"Chatterbox TTSとSuperClonica：即時クローンか、学習済みの音声ファイルか"}]}