Skip to main content
このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
Supertone API は、カスタムヘッダーによる API キー認証方式を採用しています。

​
ヘッダー

x-sup-api-key: <YOUR_API_KEY>
すべてのリクエストにこのヘッダーを含めてください。キーが欠落していたり無効な場合は 401 Unauthorized が返されます。リソースへの権限がないキーの場合は 403 Forbidden が返されます。

​
キーの発行

デベロッパーコンソール にサインインして新しいキーを作成します。1 アカウントあたり最大 3 つのアクティブキー を保有でき、コンソールからいつでも失効・再発行が可能です。

​
例

curl https://supertoneapi.com/v1/voices \
  -H "x-sup-api-key: $SUPERTONE_API_KEY"

​
認証エラー

StatusCause
401 UnauthorizedAPI キーが欠落、不正、または失効しています。
403 Forbiddenキーは有効ですが、リソースへの権限がありません（例: 別アカウントが所有するカスタムボイスの呼び出し）。
エラーカタログの全体および推奨レスポンスについては エラーハンドリング をご参照ください。

​
関連項目

Docs: Authentication

セットアップ手順、環境変数の規約、セキュリティチェックリスト。

Quickstart

キーを設定し、5 分で最初のコールを実行します。