認証とセキュリティ
Base URL、API キーの使い方、リクエスト制限。
Base URL
すべての API リクエストは次のアドレスに送信します：
https://api.marswave.ai/openapiサンドボックス／テスト環境の利用については support@marswave.ai までご連絡ください。
API キー
API キーを取得する
- API キー設定ページ を開く
- API キーを作成 をクリックする
- API キーをコピーして保管する
使い方
すべてのリクエストの Authorization ヘッダーに API キーを含めます：
curl -X GET "https://api.marswave.ai/openapi/v1/speakers/list" \
-H "Authorization: Bearer $LISTENHUB_API_KEY"const response = await fetch('https://api.marswave.ai/openapi/v1/speakers/list', {
headers: {
'Authorization': `Bearer ${process.env.LISTENHUB_API_KEY}`,
},
});import os
import requests
response = requests.get(
'https://api.marswave.ai/openapi/v1/speakers/list',
headers={'Authorization': f'Bearer {os.environ["LISTENHUB_API_KEY"]}'}
)環境変数の設定
API キーを LISTENHUB_API_KEY として保存します。本ドキュメントのコード例はすべてこの変数名を使用します：
# Add to ~/.zshrc or ~/.bashrc
export LISTENHUB_API_KEY="your_api_key_here"または、プロジェクトのルートに .env ファイルを作成します（読み込みには dotenv などのライブラリが必要です）：
# .env
LISTENHUB_API_KEY=your_api_key_hereセキュリティのベストプラクティス
API キーはアカウントの認証情報と同等です。キーが漏洩すると、意図しないクレジット消費につながる可能性があります。
- 常に HTTPS を使用する
- API キーをクライアントサイドのコードに含めない
- API キーや
.envファイルを Git リポジトリにコミットしない - API キーは環境変数に保存する
レート制限
| 制限項目 | 値 | 説明 |
|---|---|---|
| 生成リクエストのレート | 3 RPM | 1 分あたり最大 3 件の生成リクエスト |
| 制限超過時のエラーコード | 29998 | バックオフ付きのリトライ戦略を実装する |
読み取り専用のリクエスト（エピソードのステータス照会や話者の一覧取得など）は、この制限の対象外です。