クイックスタート — 30 秒で ZetaAPI に接続

登録から最初の呼び出しまで 3 ステップ。ログイン、API キー取得、Cursor / Claude Code / 任意の OpenAI SDK での切り替えを解説します。

更新日 2026-10-05

30 秒で得られるもの

• Claude / GPT / Gemini など主要モデルを呼び出せる API キー
• 普段のツール（Cursor / Claude Code / OpenAI Python SDK）で ZetaAPI を上流に設定
• コンソールでトークン消費と費用をリアルタイム表示

ステップ 1：登録とチャージ

1. コンソール を開き、Google / GitHub / メールのいずれかでログイン
2. 初回ログインでアカウントが自動作成されます（メール以外の審査はありません）
3. 「チャージ」ページで、カード / Alipay / WeChat により $1 から入金（初回はガイド付き）

ステップ 2：API キーの作成

コンソールの API Keys ページへ：

• キーを作成 をクリック
• 識別しやすい名前を付ける（例：cursor-mac、claude-code-work）
• 生成されたキー（形式 sk-xxxxx...、平文表示は一度きり）をコピー

⚠️ 完全なキーは作成時にのみ表示されます。すぐに 1Password / macOS Keychain / .env など安全な場所に保存してください。

ステップ 3：上流の切り替え

方法 A：Cursor

Settings → Models → OpenAI API Key：

• API Key：sk-xxxxx を貼り付け
• Base URL（Override OpenAI Base URL を有効化）：https://api.staging.cosmos-router.com/v1

保存後、Chat や Cmd+K の操作はすべて ZetaAPI を経由します。詳細は Cursor 設定ガイド。

方法 B：Claude Code

~/.zshrc または ~/.bashrc に追加：

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

source 後に claude を実行するだけ。詳細は Claude Code 設定ガイド。

方法 C：任意の OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxx",
    base_url="https://api.staging.cosmos-router.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Node.js 公式 SDK / LangChain / LlamaIndex / base_url を変更できる任意のクライアントも同様です。

接続の確認

最初の呼び出し後にコンソールのホームに戻ると、次が確認できます：

• 本日の消費が 0 から非ゼロに変化
• 最近の呼び出しに今のリクエストが表示（モデル、トークン、所要時間、ステータスコード）
• 5 分経っても更新がない場合は、キーまたは base URL の設定ミスです。FAQ を参照

次のステップ

• ツール別の設定 → ツール設定ガイド
• 従量課金 + Prompt Cache → 課金説明
• エンドポイント、エラーコード、レート制限 → API リファレンス