> ## 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 APIに関するよくある質問 — キー、ボイス、クレジット、エラー、連携。

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

## 開始について

<Accordion title="API Keyはどこで発行できますか？">
  [開発者コンソール](https://console.supertoneapi.com)でサインアップし、新しいキーを作成してください。**アカウントにつき最大3つのキー**を発行でき、いつでも廃棄・再発行が可能です。
</Accordion>

<Accordion title="リクエストはどのように認証しますか？">
  すべてのリクエストに`x-sup-api-key: [YOUR_API_KEY]`ヘッダーを含めてください。両方のSDKはコンストラクタでキーを受け取ります。詳しくは[認証](/ja/docs/authentication)をご覧ください。
</Accordion>

<Accordion title="Playとは別のアカウントが必要ですか？">
  いいえ。APIと[Supertone Play](https://play.supertone.ai)は同じアカウント、クレジット残高、ボイスライブラリを共有します。
</Accordion>

<Accordion title="公式にサポートされているSDKはどれですか？">
  公式SDKは2つあります。[Python](/ja/docs/developer-tools/python)（PyPIで`supertone`）と[TypeScript](/ja/docs/developer-tools/typescript)（npmで`@supertone/supertone`）です。その他の言語については、[REST API](/ja/api-reference/introduction)を直接呼び出してください。
</Accordion>

## ボイスとTTS呼び出し

<Accordion title="voice IDはどこで確認できますか？">
  3つの方法があります。(1) [Supertone Play](https://play.supertone.ai)のボイスカードからコピー、(2) `GET /v1/voices`を呼び出す、(3) `GET /v1/voices/search`でフィルタリングする。詳しくは[ボイス](/ja/docs/core-concepts/voices)をご覧ください。
</Accordion>

<Accordion title="Playで作成したクローンボイスをAPIで使用できますか？">
  はい。Playでクローンしたボイスは、同じアカウント上で即座にAPIから利用可能です。同様に、`POST /v1/custom-voices/cloned-voice`経由で作成したボイスはPlayにも表示されます。同期の手順は不要です。
</Accordion>

<Accordion title="存在するボイスに対して403が返るのはなぜですか？">
  カスタム（クローン）ボイスは、作成したアカウントからのみ呼び出すことができます。別のアカウントのキーを使用している場合、APIは`403 Forbidden`を返します。
</Accordion>

<Accordion title="ボイスはどの言語/スタイル/モデルの組み合わせをサポートしていますか？">
  ボイスオブジェクトの`samples`フィールドに、サポートされているすべての`(language, style, model)`の組み合わせと、それぞれのプレビューURLが記載されています。TTSリクエストを送信する前に確認してください。
</Accordion>

<Accordion title="styleは必須ですか？">
  いいえ。`style`を省略した場合、ボイスの`styles`配列の最初の値がデフォルトとして使用されます。
</Accordion>

<Accordion title="ピッチや速度を調整できますか？">
  はい。[Voice settings](/ja/docs/text-to-speech/voice-settings)を参照してください。モデルによってサポートされるパラメータは異なります。サポートされていない設定は黙って無視されます。
</Accordion>

<Accordion title="テキストはどのくらいの長さまで指定できますか？">
  生のAPIは`text`を**300文字**に制限しています。PythonとTypeScriptのSDKは長いテキストを自動チャンク分割して音声をマージします。詳しくは[長文](/ja/docs/text-to-speech/long-text)をご覧ください。
</Accordion>

<Accordion title="`predict_duration`は何をしますか？">
  指定されたテキストに対する生成音声の予測される長さを返します — クレジットは**消費しません**。コストプレビューやUIのヒントに有用です。詳しくは[Predict duration](/ja/docs/production/cost-and-usage#predict-duration)をご覧ください。
</Accordion>

## クレジットと料金

<Accordion title="APIはどのように課金されますか？">
  クレジットは生成された音声の秒数単位で差し引かれます。料金はPlayと同じクレジットシステムを使用しており、[Play購読ページ](https://play.supertone.ai/subscription)でクレジットを購入できます。
</Accordion>

<Accordion title="クレジット残高はどのように確認できますか？">
  2つの方法があります。(1) `GET /v1/credits`（またはSDKの`get_credit_balance`）を呼び出す、(2) コンソールまたはPlayのダッシュボードを確認する。
</Accordion>

<Accordion title="クレジットはPlayとAPIで共有されますか？">
  はい。同じ残高が両方に適用されます。クローンボイスの呼び出しも、プリセットボイスと同じ方法でクレジットを差し引きます。
</Accordion>

## エラーとトラブルシューティング

<Accordion title="最もよく発生するエラーは何ですか？">
  * **401** — API Keyの欠落または無効
  * **402** — クレジット不足
  * **403** — このアカウントが所有していないボイス
  * **400** — リクエストボディの問題（フィールド欠落、無効なenum、生のAPIで300文字超過のtext）
  * **429** — レート制限超過

  詳しいリファレンスは[エラー処理](/ja/docs/production/error-handling)をご覧ください。
</Accordion>

<Accordion title="呼び出しが繰り返し失敗します — どこを確認すればよいですか？">
  順番に確認してください。

  1. `x-sup-api-key`ヘッダーが、先頭/末尾に空白なく設定されているか。
  2. POSTリクエストに`Content-Type: application/json`があるか。
  3. `voice_id`がこのアカウントの実在するIDか（`GET /v1/voices`または`GET /v1/custom-voices`を呼び出して確認）。
  4. `text`、`language`、`style`がそのボイスのサポート内容と一致しているか。

  問題が続く場合は、リクエストボディ、ヘッダー、発生時刻を添えて[サポートにお問い合わせ](/ja/docs/resources/support)ください。
</Accordion>

<Accordion title="レート制限はどのようになっていますか？">
  デフォルトはティア別に1分あたり20 / 30 / 60リクエストです。ボイスクローンは1分あたり10回です。詳しくは[レート制限](/ja/docs/production/rate-limits)をご覧ください。
</Accordion>

## 運用

<Accordion title="誰でもAPIを使えますか？">
  はい。コンソールでサインアップすればすぐに使用できます。承認手続きはありません。
</Accordion>

<Accordion title="エンタープライズプランはありますか？">
  はい。チーム単位の利用、より高いレート制限、サブユーザーアカウント、専用容量については、[エンタープライズお問い合わせ](https://docs.google.com/forms/d/1YexQpjpK0ZEou12blTytkZLqvrV-Uv95GbhxoOQ54R8/edit)からお問い合わせください。
</Accordion>

<Accordion title="バグ報告や支援はどこに依頼すればよいですか？">
  [カスタマーサポート](https://support.supertone.ai/hc/en-us/categories/10267196754959-Play)で1:1お問い合わせを送信してください。リクエストペイロード、ヘッダー、タイムスタンプを含めると、迅速な解決につながります。
</Accordion>