> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 概要

> Supertoneを連携する方法 — 公式PythonおよびTypeScript SDK、ターミナルCLI、AIエージェント向けMCPサーバー。

<Note>
  このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は[英語の原文](/en/docs/developer-tools/overview)もあわせてご確認ください。
</Note>

Supertoneは、生のREST以外にもText-to-Speech APIを呼び出すいくつかの方法を提供します。作業スタイルに合うものを選んでください: アプリケーションコードにはSDK、ターミナルやスクリプトにはCLI、AIエージェントにはMCPサーバー。いずれも同じREST APIをラップし、OpenAPI仕様と常に同期しています。

<CardGroup cols={2}>
  <Card title="Python SDK" icon="python" href="/ja/docs/developer-tools/python">
    `pip install supertone` — 同期および非同期クライアント、並列自動チャンク分割。
  </Card>

  <Card title="TypeScript SDK" icon="js" href="/ja/docs/developer-tools/typescript">
    `npm add @supertone/supertone` — Promiseベース、ESM/CJS、NodeおよびBun対応。
  </Card>

  <Card title="CLI" icon="terminal" href="/ja/docs/developer-tools/cli">
    `pip install supertone-cli` — ターミナルから合成・ストリーミング・一括処理とボイス管理。
  </Card>

  <Card title="MCP" icon="robot" href="/ja/docs/developer-tools/mcp">
    `uvx supertone-mcp` — Claude、Cursorなどのエージェント向けの組み合わせ可能なツール。
  </Card>
</CardGroup>

## どれを使えばいい?

| やりたいこと                          | 使うもの                                                                                              | 対象                          |
| ------------------------------- | ------------------------------------------------------------------------------------------------- | --------------------------- |
| PythonやNodeのコードからSupertoneを呼び出す | [Python](/ja/docs/developer-tools/python) / [TypeScript](/ja/docs/developer-tools/typescript) SDK | アプリケーション開発者                 |
| シェル、スクリプト、CIでオーディオを生成・一括処理する    | [CLI](/ja/docs/developer-tools/cli)                                                               | DevOps、コンテンツ/スクリプティング       |
| AIエージェントにボイス検索や音声合成をさせる         | [MCPサーバー](/ja/docs/developer-tools/mcp)                                                           | Claude / Cursor / エージェント利用者 |
| SDKのない言語を使う、またはワイヤフォーマットを制御する   | [REST API](/ja/api-reference/introduction)                                                        | あらゆるランタイム                   |

## 各ツールが提供するもの

**SDK（Python & TypeScript）** — アプリケーションコード向けのイディオマティックなクライアントです。認証処理、型安全なモデル・enum、オーディオチャンクのストリーミング、長文の自動チャンク分割（300文字で分割し透過的に結合）、HTTPステータスコードに対応した型付きエラー、バックオフ付きの設定可能なリトライを提供します。詳細な機能表は各SDKのページにあります。

**CLI** — ターミナルとスクリプトから使うAPIです。文字列・ファイル・標準入力から合成し、スピーカーへストリーミングし、ディレクトリ全体を一括処理し、ボイスを管理・クローンし、使用量の確認や長さの予測ができます。`--format json`出力はパイプに適しており、一般的な終了コードでスクリプトから失敗を分岐処理できます。

**MCPサーバー** — AIエージェント（Claude、Cursorなどの MCP クライアント）がSupertoneを操作できるようにする組み合わせ可能なツールです。エージェントはボイスの検索・試聴、コスト見積もり、ボイスのクローン、音声合成を行い — これらのステップを自ら多段階のワークフローに連結します。

## REST APIを直接使う場合

REST APIは、SDKが提供されていない言語やランタイム（Go、Java、PHP、Rust、組み込みシステムなど）、またはワイヤフォーマットを最大限にコントロールしたい場合に使用できます。各エンドポイントは[APIリファレンス](/ja/api-reference/introduction)に記載されており、そのセクションのサンプルには`curl`、JavaScript、Go、Python、PHP、Javaが含まれています。

REST APIを直接呼び出す場合は、チャンク分割、リトライ、ストリーミングの消費を自前で実装する必要があります。