よくある質問

アカウント、セキュリティ、課金、互換性、トラブルシューティング。困ったらまずここを。90% の問題は 1 分で解決します。

更新日 2026-04-17

アカウントとキー

なくした API キーは復元できますか？

できません。キーは作成時に一度だけ平文表示され、その後はハッシュのみ保存されます。なくした場合はコンソールで旧キーを失効 → 新キーを作成の 2 ステップで対応してください。

1 アカウントでいくつキーを作れますか？

既定で 20 個、上限引き上げを申請できます。用途で分けるのがおすすめです：cursor-mac、claude-code-work、ci-prod など。監査と失効が容易になります。

あるキーの消費を制限するには？

コンソールの API Keys → 編集で、キーごとに設定できます：

日次上限（USD）
月次上限（USD）
呼び出し可能なモデルのホワイトリスト

超過するとそのキーは自動で一時停止され、他のキーには影響しません。

アカウントを削除できますか？

できます。コンソールの設定 → アカウントセキュリティ → アカウント削除から。ソフト削除は 30 日以内なら取り消し可能で、その後は GDPR の手順で物理削除します。詳細はプライバシーポリシー。

課金

料金はどう計算しますか？

従量課金 = (入力トークン × 入力単価 + 出力トークン × 出力単価) × モデル倍率。倍率は 0.3×〜0.4× で公式より安いです。詳細は料金ページ。

初回チャージはいくらが目安？

最低 $1。まず $2–10 で接続をテストし、ツールチェーンが通ったら本格的にチャージするのがおすすめです。

請求書（インボイス）は発行できますか？

中国の増値税（VAT）インボイスは発行しません（普通・専用いずれも不可）。どうしても必要な場合は、ご要望に応じて海外向けのプロフォーマインボイスを提供できます。プロフォーマインボイスは中国の税務インボイスではなく、中国国内での VAT 控除や経費精算には使用できません。

残高の返金ルールは？

チャージ残高：無理由返金不可（未消費分を含む）
使用済み分：返金不可
受動的返金：法令上の要求や重大な障害など特定の場合のみ対応（返金ポリシー参照）
プラットフォーム障害による損失：申請にもとづく審査のうえ残高へ補償（ルール公開）

詳細は返金ポリシーと赔付ルールをプロダクトに。

互換性

OpenAI SDK に対応していますか？

対応しています。/v1/chat/completions、/v1/embeddings などすべての OpenAI エンドポイントに完全互換で、base_url = "https://api.staging.cosmos-router.com/v1" に変えるだけです。

Anthropic 公式 SDK に対応していますか？

対応しています。anthropic の Python / Node SDK は環境変数を 2 つ変えれば動きます：

export ANTHROPIC_BASE_URL="https://api.staging.cosmos-router.com"
export ANTHROPIC_API_KEY="sk-xxxxx"

function calling / tool use に対応していますか？

対応しています。OpenAI の tools パラメータと Anthropic の tools は、いずれも上流へそのまま透過し書き換えません。

ストリーミング / SSE に対応していますか？

対応しています。stream: true の挙動は公式と完全に同一です。

prompt cache に対応していますか？

対応しています。OpenAI の自動キャッシュと Anthropic の明示的な cache_control は、いずれも公式料率で課金されます（キャッシュヒット = 入力価格の 10%–50%）。

トラブルシューティング

呼び出しが 401 Unauthorized を返す

キーが sk- で始まるか確認（公式の sk-ant- ではない）
キーが失効していないか確認（コンソールの API Keys ページで状態を確認）
ヘッダー形式を確認：Authorization: Bearer sk-xxxxx（Bearer の後にスペース）

呼び出しが 402 Insufficient Quota を返す

残高不足、またはキーが日次/月次上限に達しています。コンソールでチャージするか上限を引き上げてください。

呼び出しが 429 Rate Limit を返す

既定の制限は 600 RPM / 300k TPM
クライアントは指数バックオフで再試行を（Retry-After ヘッダーが秒数を示します）
高頻度の用途はコンソールで上限引き上げを申請

呼び出しが遅い・タイムアウトする

ステータスページ（/ja/status）で障害切替中でないか確認
Claude / GPT の大型モデルは初トークンまで 1–3 秒は正常です
10 秒以上続く場合は、コンソールの最近の呼び出しでそのリクエストの上流応答時間を確認。上流で待ち行列の可能性

応答が公式と異なる

ZetaAPI はリクエストとレスポンスをそのまま透過し、prompt の書き換えや結果のフィルタリングはしません。差異が見える場合、ほとんどは次のいずれかです：

モデルのバージョン不一致（gpt-4o には複数のスナップショットがあります）
temperature / top_p などのパラメータの違い
ランダム性（seed を固定すれば再現できます）

それでも中継の問題を疑う場合は、リクエスト ID（レスポンスヘッダー x-request-id）を添えてチケットを起票してください。

セキュリティ

私の prompt とレスポンスは記録されますか？

メタデータ（モデル名、トークン数、所要時間、ステータスコード）は課金・監視のため 90 日保持します
prompt とレスポンスの内容は既定で記録しません。自分で「デバッグログ」を有効にした場合のみ 7 日記録します
スタッフはユーザー内容にアクセスできず、監査ログは公開しています

通信は暗号化されますか？

全経路 TLS 1.3 で、クライアント側も上流側も HTTPS を強制します。

キーが漏えいしたら？

ただちにコンソールの API Keys ページでそのキーを失効してください（即時反映、10 秒以内に全体で無効化）。プラットフォームは GitHub 上に露出したキーも自動監視し、能動的に通知します。

まだ答えが見つからない？

技術的な詳細は API リファレンスを参照
最近の変更かどうかは Changelog を確認
コンソール右下からチケットを起票。営業時間内 2 時間以内に応答します