FAQ

TokSpanは 統合AI APIゲートウェイ であり、OpenAI、Anthropic、Google、Meta、DeepSeekを含む 50以上のプロバイダーから200以上のモデル にアクセスできる単一のOpenAI互換エンドポイントを提供します。

仕組みは次のとおりです：標準のOpenAI形式でTokSpanのAPIにリクエストを送信します。TokSpanがリクエストを適切な上流プロバイダーにルーティングし、必要に応じて形式を変換し、レスポンスを処理して返します。お客様の視点では、1つのAPI を呼び出すだけです — TokSpanがモデルルーティング、負荷分散、レート制限、自動フェイルオーバー、コスト追跡をバックグラウンドで管理します。

必要なのはTokSpanアカウントだけです。すべての上流プロバイダーとの関係は弊社が代行します — OpenAI、Anthropic、Googleの個別アカウントは不要です。

• 1つのキーですべてのモデルに — 単一のAPIキーでGPT-4o、Claude Opus、Gemini Pro、DeepSeek V3にアクセス。複数のプロバイダーで課金アカウントを管理する必要なし。
• ベンダーロックインなし — 1つのパラメーターを変更するだけでモデルを切り替えられます。どのプロバイダーがリクエストを処理してもコードは変わりません。
• 自動フェイルオーバー — プロバイダーがダウンした場合、トラフィックは自動的にバックアップモデルにルーティング。手動介入ゼロ。
• グローバルリーチ — 世界中の開発者にサービスを提供するグローバルエッジネットワーク。
• コストの可視性 — すべてのモデルとプロバイダーにわたる統合課金とリアルタイム使用量追跡を1つのダッシュボードで。

開始まで約5分です：

1. api.tokspan.com/register で サインアップ
2. クレジットカード、PayPal、または銀行振込でアカウントに クレジットを追加
3. ダッシュボード → APIキー ページから APIキーを作成
4. base_url を https://api.tokspan.com/v1 に変更して新しいキーを使用し、最初の呼び出しを実行

すでにOpenAI SDKを使用している場合、30秒で完了します。Python、TypeScript、curlのコード例については クイックスタートガイド を参照してください。

恒久的な無料枠は提供していません — それが実際にお客様にとって良い理由は次のとおりです：

• 品質を犠牲にする無料枠はありません — 大規模な無料枠はインフラ、サポート、モデルアクセスの妥協を必要とします。弊社はすべてを信頼性とモデルカバレッジに投資しています。
• 使った分だけ支払う — 最低利用義務なし。必要な分だけチャージできます。ほとんどの開発者は最初の1か月のテストで$5未満しか使いません。
• すべてのモデル、制限なし — チャージ残高があれば、プラットフォーム上のすべての最先端モデルにすぐにアクセスできます — 「無料枠限定」モデルの制限はありません。

新規アカウントには随時プロモーション用のスタータークレジットが付与される場合があります。サインアップ後、ダッシュボード を確認してください。

主要な全カテゴリにわたって 200以上のモデル にアクセスできます：LLM（GPT-4o、Claude Opus 4.8、Gemini 2.5 Pro、DeepSeek V3、Llama 4、Mistral Large 3）、ビジョンおよびマルチモーダル、埋め込みおよびリランキング、音声およびオーディオ（TTS + STT）。

最新のトークン単位料金を含む完全なライブカタログは api.tokspan.com/pricing でご覧いただけます。カテゴリ概要と機能比較については モデルドキュメント を参照してください。

TokSpanは各プロバイダーの基本料金に加えて 小額で透明なサービス手数料 を課金します。消費したトークンに加えて、弊社のインフラ、ルーティング、グローバルエッジネットワーク、サポートをカバーするマージンをお支払いいただきます。

すべてのモデルのトークン単位料金（サービス手数料込み）は、呼び出し前に モデルハブ でリアルタイムに確認できます。表示された価格がお支払いいただく価格です — 隠れたコストや予期しない課金はありません。

月額サブスクリプション および 最低利用義務 はありません。任意の金額をチャージしてすぐにモデルの呼び出しを開始できます。

グローバルなお客様向けに複数の支払いオプションをサポートしています：

• クレジットカード / デビットカード — Visa、Mastercard、American Express（Stripe経由）。標準のカード手数料が適用されます。
• PayPal — 200以上の国と地域で利用可能。
• 銀行振込（電信送金） — エンタープライズアカウントで利用可能（最低課金額: $500）。処理時間: 1～3営業日。

すべての支払いはUSD建てです。カード/PayPal支払いの残高は即時に反映され、電信送金は確認後に反映されます。

はい、以下のポリシーに従います：

• クレジットカード / PayPal支払い — 未使用のクレジットは購入から 7日以内 であれば返金対象となります。プラットフォームサービス手数料（プロバイダー料金に上乗せされるマージン）のうち、既に消費されたトークン分は返金不可です。
• 銀行振込 — 返金は5～10営業日以内に処理され、電信手数料が差し引かれます。

返金をリクエストするには、アカウントのメールアドレスと支払い詳細を添えて support@tokspan.com までご連絡ください。

はい。未使用のクレジットは購入から12か月で失効します。 このポリシーにより、プロバイダー側の負債を管理しながらサービス手数料を可能な限り低く抑えることができます。クレジット失効の30日前と7日前にメールリマインダーが送信されます。失効日はダッシュボードの 課金 → クレジット で確認できます。

自動トップアップにより、残高がゼロになるのを防ぎます：

1. ダッシュボード → 課金 → 自動トップアップ に移動
2. 閾値 を設定（例: $5 — 残高がこれを下回ると自動チャージが実行されます）
3. 金額 を設定（例: $20 — 毎回追加する金額）
4. 支払い方法を選択

自動トップアップのたびにメール領収書が送信されます。いつでも無効化または調整できます。本番ワークロードでは 402 の中断を避けるために有効化することを推奨します。

複数のレイヤーでコスト管理が可能です：

• キーごとの月間予算 — APIキーごとにハードキャップを設定。上限に達すると、制限を引き上げるかサイクルがリセットされるまでリクエストは拒否されます。
• モデルごとのレート制限 — 各APIキーにカスタムRPM（1分あたりのリクエスト数）とTPM（1分あたりのトークン数）の制限を設定。
• モデルホワイトリスト — キーを特定のモデルのみに制限（例: 開発キーでは安価なモデルのみ許可）。
• IPホワイトリスト — キーの使用を特定のIPアドレスまたは範囲に制限。
• リアルタイム使用量ダッシュボード — ダッシュボードでキー、モデル、期間ごとの利用額を監視。

すべての制限はキーの作成時または編集中に ダッシュボード → APIキー から設定します。詳細は キースコーピング を参照してください。

トークンは上流プロバイダーと全く同じ方法でカウントされます：プロンプトトークン + 補完トークン = 課金対象の合計トークン数。各プロバイダーのトークナイザーを透過的に使用するため、プロバイダーを直接呼び出した場合と同じカウントになります。

マルチモーダル入力（画像、音声、動画）の場合：各プロバイダーはメディアをトークン換算する独自の計算式を持っています。弊社はプロバイダーの計算をそのまま通過させます — ダッシュボードには最終的なトークン数とコストが表示されます。一般的に：高解像度の画像は1枚あたり約85～170トークン（GPT-4o）、音声は1秒あたり約50トークン（Whisper）です。

プロンプトキャッシング（Claude、GPT-4o）対応モデルの場合、キャッシュされたプロンプトトークンはプロバイダーの割引キャッシュレートで課金されます。使用量ダッシュボードでは通常とキャッシュのトークン利用額が内訳表示されます。

いいえ — プロンプトや補完内容は保存されません。 データはリアルタイムで弊社のインフラを通過し、永続化されません。課金の正確性と不正利用防止のため、リクエストの メタデータのみ（モデル、トークン数、タイムスタンプ、APIキーID）をログに記録します。これはお客様の使用量を計算しプラットフォームを保護するために必要です。

お客様のプロンプトや補完内容をモデルトレーニングに使用することは決してなく、データを第三者に販売または共有することもありません。

データの完全な不可視性（メタデータすら見られたくない場合）が必要な場合、TokSpanは 完全にセルフホスティング可能 です — ファイアウォールの内側にデプロイして完全なデータ主権を維持できます。下記の セルフホスティングは可能ですか？ を参照してください。

これはプロバイダーと設定によって異なります：

• OpenAI — API呼び出しのデータをトレーニングに使用 しません（2023年3月現在）。APIを通じて送信されたデータはデフォルトでモデルトレーニングに使用されません。
• Anthropic — APIデータをトレーニングに使用 しません。Claude APIデータは明示的にオプトインしない限りモデル改善に使用されません。
• Google (Gemini) — 有料APIの使用データをトレーニングに使用 しません。無料枠の使用は異なる条件が適用される場合があります。
• その他のプロバイダー — ポリシーは様々です。各プロバイダーの利用規約を確認してください。懸念がある場合はプロバイダーのデータ使用ポリシーを確認することを推奨します。

最大限の管理のために、TokSpanをセルフホスト し、明確な「トレーニングなし」ポリシーを持つプロバイダーで上流APIキーを設定してください。データがどのプロバイダーに触れるかを完全に管理できます。

すべてのAPIキーは保存時に暗号化（AES-256）されています。キーは作成時に一度だけ表示され、失われたキーを復元することはできません（新しいキーを生成し、古いキーを無効化してください）。すべてのAPIトラフィックは転送時にTLS 1.3で暗号化されます。多層防御として、IPホワイトリスト、モデル制限、月間利用上限を設定したAPIキーの使用を推奨します。セキュリティのベストプラクティスとして、90日ごとにキーをローテーションしてください。

セキュリティはTokSpanの基盤です。当社のインフラストラクチャは以下の管理策を中心に構築されています：

• TLS 1.3 — 転送中のすべてのデータはエンドツーエンドで暗号化されます。
• AES-256 — APIキーと認証情報は保存時に暗号化されます。
• MFA — すべてのアカウントで多要素認証をサポートしています。
• GDPR準拠のプラクティス — データ最小化とプライバシー開示はプライバシーポリシーに記載されています。

セキュリティ体制の詳細については、エンタープライズのお客様はsupport@tokspan.comまでお問い合わせいただけます。

はい。当社のホステッドサービスはGDPRおよびCCPAの要件を実装しています：データ最小化（プロンプトやコンプリーションは保存しません）、目的制限（メタデータは課金および不正使用防止のみに使用）、リクエストに応じたユーザーデータの削除、透明性のあるデータ処理の開示。

厳格なデータレジデンシーおよびコンプライアンス要件については、セルフホスティングにより完全な管理が可能です。TokSpanを任意のリージョンの自社インフラストラクチャ上で、ファイアウォールの内側にデプロイできます。DPA（データ処理契約）についてはsupport@tokspan.comまでお問い合わせください。

ダッシュボード → 設定 → アカウント → アカウント削除から、アカウントと関連するすべてのデータを削除できます。アカウントの削除は永久的で元に戻せません。

残高について：

• 削除時点の残りのクレジットは没収されます。削除を開始する前に、残高を使用するか返金をリクエストすることを推奨します。
• 法律で義務付けられている請求記録（支払い領収書、請求書）は、法定期間（通常7年間）保持されます。
• その他のすべてのアカウントデータ（APIキー、使用ログ、メールアドレス、設定）は、30日以内に完全に消去されます。

はい。DPAはエンタープライズアカウントおよびチームアカウントでご利用いただけます。当社は、GDPRデータ処理者の義務、サブプロセッサーの開示、越境転送保護措置（SCC）、および侵害通知のコミットメントをカバーする標準DPAを提供します。法務チームの要件を添えてsupport@tokspan.comまでご連絡ください。通常2〜3営業日で対応いたします。

はい、100%対応しています。base_urlをhttps://api.tokspan.com/v1に変更するだけで、既存のOpenAI SDKコードがPython、Node.js、Go、curl、または任意のOpenAI互換ライブラリですぐに動作します。

サポートされる機能：

• Chat Completions — システム/ユーザー/アシスタントメッセージを含む完全サポート
• ストリーミング — stream: trueによるSSE（Server-Sent Events）
• Function / Tool Calling — 並列ツール呼び出し、strictモード
• JSON Mode — response_formatによる構造化出力
• Vision / Image Input — URLおよびbase64画像
• Embeddings — 複数プロバイダーにわたる完全サポート
• Audio — TTS（テキスト読み上げ）およびSTT（音声認識 / Whisper）
• Images — DALL·Eおよび互換モデルによる生成
• Rerank — 完全サポート
• Reasoning Effort — モデルサフィックスによる推論深度の制御（下記参照）

モデル名にサフィックスを追加して推論深度を制御します：

サフィックスが指定されない場合、モデルのデフォルトの推論レベルが使用されます。これにより、統合コードを変更することなく、リクエストごとに速度とコストと回答品質のトレードオフが可能です。詳細はモデル → 推論努力をご覧ください。

推論サフィックスに加えて、TokSpanはリクエストのルーティング方法を制御するルーティング指向のバリアントをサポートしています：

サポートされている場合はサフィックスを組み合わせてください：例：gpt-5-high-fastは最大推論と最低レイテンシのルーティングを組み合わせます。モデルごとのサフィックス互換性についてはモデルドキュメントをご覧ください。

はい。上流プロバイダーがサポートしている場合（Claude、GPT-4o、Gemini）、プロンプトキャッシングは自動的に適用されます。同じプロンプトプレフィックスを複数のリクエストに送信すると、プロバイダーが計算をキャッシュし、キャッシュされた部分に対して割引料金（通常、フルプロンプトトークン価格の90%オフ）で課金します。

コードを変更する必要はありません。TokSpanはプロバイダーからのキャッシュステータスを透過的に通過させ、ダッシュボードにキャッシュ使用トークンと非キャッシュ使用トークンが表示されます。キャッシュヒットを最大化するには：

• 静的なコンテンツ（システムプロンプト、コンテキストドキュメント）をプロンプトの先頭に配置してください
• 動的なコンテンツ（ユーザーメッセージ、最新のクエリ）を末尾に配置してください
• 同じシステムプロンプトをリクエスト間で再利用してください

最適化ガイド全文はこちら：プロンプトキャッシング。

はい。TokSpanはBring Your Own Keyをサポートしています。ダッシュボードで独自のOpenAI、Anthropic、Google、その他のプロバイダーAPIキーを追加できます。BYOKを設定すると：

• そのプロバイダーへのリクエストは、TokSpanのプールではなくお客様のキーを通じてルーティングされます
• プロバイダーへの支払いは直接行われ、TokSpanはBYOKリクエストにサービス手数料を追加しません
• TokSpanの統合エンドポイント、フェイルオーバー、コスト追跡を引き続き利用できます
• BYOKキーとTokSpanのプールを組み合わせて使用可能：プライマリプロバイダーには自分のキーを使用し、その他のプロバイダーには当社のプールにフォールバックします

BYOKは、既存のプロバイダー関係、エンタープライズ割引、または厳格な課金分離要件を持つチームに最適です。ダッシュボード → 設定 → プロバイダーキーから設定してください。

TokSpanは標準のHTTPステータスコードを返します：

429および5xxエラーにはジッター付き指数バックオフの実装を推奨します。エラーレスポンスボディを含む完全なリファレンスはエラーコードをご覧ください。

ホステッドAPIの稼働率目標は99.99%です。当社のインフラストラクチャは、単一障害点のない複数のアベイラビリティゾーンにまたがって水平スケーリングされています。ミッションクリティカルなワークロードには、セルフホストデプロイメントにより稼働率目標を完全に制御できます。

エンタープライズプランには、稼働時間のコミットメント、クレジットペナルティ、優先インシデント対応を含む正式なSLAが含まれます。SLA条件についてはsupport@tokspan.comまでお問い合わせください。

TokSpanは、次の優先モデルに自動的にフェイルオーバーします。当社のシステムは：

1. プロバイダーの利用不可（5xxエラー、タイムアウト）を数秒以内に検出します
2. 最近停止が発生したプロバイダーをスキップします（30秒のクールダウン期間）
3. フェイルオーバーチェーン（ダッシュボード → チャネルで設定可能）の次のモデルにルーティングします

適切に設計されたチェーン（例：GPT-4o → Claude Opus → Gemini Pro）により、リクエスト消失ゼロが保証されます。最終的にリクエストを処理したモデルに対してのみ課金され、失敗した試行は課金されません。セットアップ手順は自動フェイルオーバーをご覧ください。

TokSpanは最小限のルーティングオーバーヘッド（通常100ms未満）を追加します。主要なレイテンシ要因は上流モデルの生成速度（初回トークンまでの時間およびトークン毎秒）であり、TokSpanを経由しても影響を受けません。

レイテンシ重視のアプリケーション向け：

• ストリーミング（stream: true）を有効にして、トークン生成中にユーザーが結果を確認できるようにしてください
• -fastモデルサフィックスを使用して、最小レイテンシのプロバイダーに自動ルーティングしてください
• ネットワークオーバーヘッドゼロのために、アプリケーションと同じリージョンにセルフホストインスタンスをデプロイしてください

はい。リアルタイムのサービス状態、インシデント履歴、計画メンテナンス期間についてはAPIステータスページをご確認ください。メール、Slack、またはWebhookでインシデント通知を購読できます。設定についてはWebhookをご覧ください。

ダッシュボードにログインし、APIキーに移動して+ 新規キーをクリックします。各キーにわかりやすい名前（例：「production-backend」「mobile-app-dev」「staging-test」）を付けてください。キーは無制限に作成できます。

環境ごとに個別のキー（開発、ステージング、本番）を作成することを強く推奨します。各キーは独立した使用量追跡、利用上限、モデル制限を持ち、環境ごとまたはクライアントごとのコスト監視が容易になります。開発キーが侵害されても、本番キーは影響を受けません。

ダッシュボードから直ちに無効化してください。無効化は即時に有効になります（反映まで60秒未満）。新しいキーを生成し、アプリケーションを更新してください。削除前に古いキーの使用ログに不審なアクティビティがないか監視してください。

予防のベストプラクティス：

• IPホワイトリストを使用して、キーの使用元を制限してください
• キー漏洩時の被害範囲を制限するために月間利用上限を設定してください
• 90日ごとにキーをローテーションしてください
• キーをバージョン管理にコミットしないでください。環境変数またはシークレットマネージャーを使用してください

ダッシュボードから環境ごとに個別のAPIキーを作成してください：

• 開発 — 厳しめの利用上限（$10/月）、安価なモデルに制限、IP制限なし（ローカル開発用）
• ステージング — 中程度の上限（$50/月）、本番と同じモデル、ステージングサーバーにIP制限
• 本番 — 必要に応じて高い上限、すべてのモデル、本番サーバーにIP制限

各キーには独自の使用量ダッシュボード、アラート、アクティビティログがあります。このセットアップにより、環境ごとのコスト可視性が得られ、開発フェーズのバグで本番予算が消費されるのを防ぎます。完全な設定リファレンスはキースコーピングをご覧ください。

はい。TokSpanはDocker、Docker Compose、またはKubernetesを使用して独自のインフラストラクチャにデプロイできます。セルフホスティングにより以下が可能です：

• 完全なデータ主権 — データがお客様のインフラストラクチャを一切離れません
• 完全なログ管理 — 何をログに記録し、どこに保存するかをお客様が決定します
• レイテンシオーバーヘッドゼロ — アプリケーションと同じリージョンにデプロイ
• 無制限のカスタマイズ — ニーズに合わせてプラットフォームを調整できます

当社のデプロイメントガイドを参照するか、support@tokspan.comまでお問い合わせください。

はい。TokSpanは専用の管理制御を備えたチームおよびエンタープライズデプロイメントをサポートしています：

• チームワークスペース — サブキー、ロール、キーごとの利用制限
• 統合課金 — すべてのモデルとチームにわたる1つの請求書
• カスタムレート制限 — お客様のワークロードに合わせてスケール

専用デプロイメントオプションについてはsupport@tokspan.comまでお問い合わせください。

はい。エンタープライズプランには以下が含まれます：

• 専任アカウントマネージャー — すべての質問に対応する単一の窓口
• 優先サポート — 保証された応答時間（重大な問題は通常2時間以内）
• カスタムSLA — お客様のニーズに合わせたクレジットペナルティ付き稼働時間コミットメント
• 一括請求 — Net-30/60条件、発注書、マルチ通貨請求
• カスタムレート制限 — お客様のワークロードに合わせたRPM/TPM制限
• デプロイメント支援 — アーキテクチャレビュー、Helmチャートカスタマイズ、オンプレミスセットアップ

要件を添えてsupport@tokspan.comまでご連絡ください。1営業日以内にご提案をまとめます。

当社のホステッドインフラストラクチャは現在、最適なレイテンシのためにグローバルなエッジロケーションでデータを処理しています。厳格なデータレジデンシー要件（例：GDPRデータをEU内に留める必要がある場合や特定の国内規制）については、TokSpanは完全にセルフホスティング可能です。任意のリージョンの自社サーバー上に、ファイアウォールの内側で、完全なデータ主権を持ってデプロイできます。

エンタープライズのお客様は、当社チームが管理する専用リージョンデプロイメントについてもご相談いただけます。対象リージョンでの利用可能性についてはsupport@tokspan.comまでお問い合わせください。

複数のサポートチャネルをご用意しています：

• メール — support@tokspan.com（課金、アカウント、技術的な質問）。24時間以内に回答し、ほとんどの質問は1回のやり取りで解決します。
• ステータスページ — リアルタイムのインシデント更新はAPIステータス。停止時に通知を受け取るには購読してください。

エンタープライズのお客様には、当社のエンジニアリングチームとの共有Slackチャネルを提供し、リアルタイムのコラボレーションが可能です。