> AI エージェント向け：セットアップの手順ガイド — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md)、ドキュメントのインデックス — [`/llms.txt`](https://gate.joingonka.ai/llms.txt)。 # Gonkaのモデルをあなたのツールに接続 OpenAIおよびAnthropic互換API。ツールを選んで、インストールコマンド・エージェント用プロンプト・動作確認を取得しましょう。 ## クイックファクト - OpenAI APIクライアント用のベースURL: `https://gate.joingonka.ai/v1` - Anthropic APIクライアント用のベースURL（`/v1`なし）: `https://gate.joingonka.ai` - キーは`Authorization: Bearer jg-…`または`x-api-key: jg-…`ヘッダーで渡します - 利用可能なモデル一覧: `GET https://gate.joingonka.ai/v1/models` - 推奨モデル: `MiniMaxAI/MiniMax-M2.7` ## ツールを接続 ツールを選ぶと、そのツール専用の3ステップが下に表示されます。インストーラーは下の表にあるツール（25個）を1コマンドで設定し、それ以外はガイドに沿って接続します。 ### キー [gate.joingonka.ai](https://gate.joingonka.ai/register)で登録し、マイページでキーを作成してください。 登録直後に3M分の無料トークンがアカウントに付与されます。 ### 接続 インストーラーがツールを自動設定します。キーを非表示入力で尋ね、設定ファイルに書き込み、接続を確認します。`--tool`に渡す値は下のツール表にあります。 ```bash npx -y @joingonka/setup --tool --model MiniMaxAI/MiniMax-M2.7 ``` またはAIエージェントに設定を任せましょう。以下のプロンプトを送ってください： ```text 自分のツールをJoinGonka Gateway（GonkaネットワークのOpenAIおよびAnthropic互換API）に、https://gate.joingonka.ai/docs/agents.mdの手順に従って接続してください。キーは私が渡します。リポジトリのファイルに保存したり、グローバル環境変数を変更したりしないでください。最後に短いリクエストで接続を確認し、結果を報告してください。 ``` 各ツールのステップバイステップガイドは下の表のリンクから。 ### 確認 アカウント残高 — このリクエストはトークンを消費しません： ```bash curl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY" ``` モデルへの短いリクエスト — ステータスコード200が返れば設定完了です： ```bash curl -s https://gate.joingonka.ai/v1/chat/completions \ -H "Authorization: Bearer $JOINGONKA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 32}' ``` ### すべてのツール | ツール | タイプ | インストーラー | | --- | --- | --- | | [Cursor](https://joingonka.ai/ja/knowledge/cursor/) | IDE | `--tool cursor` | | [Claude Code](https://joingonka.ai/ja/knowledge/claude-code/) | CLIエージェント | `--tool claude-code` | | [OpenClaw](https://joingonka.ai/ja/knowledge/openclaw/) | CLIエージェント | `--tool openclaw` | | [OpenCode](https://joingonka.ai/ja/knowledge/opencode/) | CLIエージェント | `--tool opencode` | | [Continue](https://joingonka.ai/ja/knowledge/continue-dev/) | IDE | `--tool continue` | | [Cline](https://joingonka.ai/ja/knowledge/cline/) | IDE | `--tool cline` | | [Aider](https://joingonka.ai/ja/knowledge/aider/) | CLIエージェント | `--tool aider` | | [LangChain](https://joingonka.ai/ja/knowledge/langchain/) | フレームワーク | — | | [n8n](https://joingonka.ai/ja/knowledge/n8n/) | フレームワーク | — | | [Open WebUI](https://joingonka.ai/ja/knowledge/open-webui/) | チャット | — | | [LibreChat](https://joingonka.ai/ja/knowledge/librechat/) | チャット | — | | [Hermes](https://joingonka.ai/ja/knowledge/hermes/) | CLIエージェント | `--tool hermes` | | [Kilo Code](https://joingonka.ai/ja/knowledge/kilo-code/) | IDE | `--tool kilo` | | [Roo Code](https://joingonka.ai/ja/knowledge/roo-code/) | IDE | `--tool roo` | | [LlamaIndex](https://joingonka.ai/ja/knowledge/llamaindex/) | フレームワーク | — | | [PydanticAI](https://joingonka.ai/ja/knowledge/pydantic-ai/) | フレームワーク | — | | [Vercel AI SDK](https://joingonka.ai/ja/knowledge/vercel-ai-sdk/) | フレームワーク | — | | [TanStack AI](https://joingonka.ai/ja/knowledge/tanstack-ai/) | フレームワーク | — | | [ZCode](https://joingonka.ai/ja/knowledge/zcode/) | CLIエージェント | `--tool zcode` | | [JetBrains](https://joingonka.ai/ja/knowledge/jetbrains/) | IDE | `--tool jetbrains` | | [Copilot BYOK](https://joingonka.ai/ja/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` | | [Zed](https://joingonka.ai/ja/knowledge/zed/) | IDE | `--tool zed` | | [Pi](https://joingonka.ai/ja/knowledge/pi/) | CLIエージェント | `--tool pi` | | [Codex CLI](https://joingonka.ai/ja/knowledge/codex/) | CLIエージェント | `--tool codex` | | [DeepSeek Harness](https://joingonka.ai/ja/knowledge/deepseek-harness/) | CLIエージェント | — | | [MiniMax Code](https://joingonka.ai/ja/knowledge/minimax-code/) | CLIエージェント | `--tool minimax-code` | | [Warp](https://joingonka.ai/ja/knowledge/warp/) | CLIエージェント | — | | [Trae](https://joingonka.ai/ja/knowledge/trae/) | IDE | — | | [Cherry Studio](https://joingonka.ai/ja/knowledge/cherry-studio/) | チャット | — | | [omp (Oh My Pi)](https://joingonka.ai/ja/knowledge/omp/) | CLIエージェント | `--tool omp` | | [OpenHands](https://joingonka.ai/ja/knowledge/openhands/) | CLIエージェント | — | | [Qwen Code](https://joingonka.ai/ja/knowledge/qwen-code/) | CLIエージェント | `--tool qwen-code` | | [Goose](https://joingonka.ai/ja/knowledge/goose/) | CLIエージェント | `--tool goose` | | [Crush](https://joingonka.ai/ja/knowledge/crush/) | CLIエージェント | `--tool crush` | | [Zoo Code](https://joingonka.ai/ja/knowledge/zoo-code/) | IDE | `--tool zoo` | | [Kimi Code](https://joingonka.ai/ja/knowledge/kimi-code/) | CLIエージェント | `--tool kimi-code` | | [Factory Droid](https://joingonka.ai/ja/knowledge/factory-droid/) | CLIエージェント | `--tool droid` | | [MiMo Code](https://joingonka.ai/ja/knowledge/mimo-code/) | CLIエージェント | `--tool mimo-code` | ## コードサンプル 同じリクエストをOpenAI SDK、cURL、Anthropic SDKで。キーは環境変数`JOINGONKA_API_KEY`から取得します。 ### Python ```python import os from openai import OpenAI client = OpenAI( base_url="https://gate.joingonka.ai/v1", api_key=os.environ["JOINGONKA_API_KEY"], ) response = client.chat.completions.create( model="MiniMaxAI/MiniMax-M2.7", messages=[{"role": "user", "content": "What is Gonka?"}], ) print(response.choices[0].message.content) ``` ### TypeScript ```typescript import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://gate.joingonka.ai/v1", apiKey: process.env.JOINGONKA_API_KEY, }); const response = await client.chat.completions.create({ model: "MiniMaxAI/MiniMax-M2.7", messages: [{ role: "user", content: "What is Gonka?" }], }); console.log(response.choices[0].message.content); ``` ### cURL ```bash curl https://gate.joingonka.ai/v1/chat/completions \ -H "Authorization: Bearer $JOINGONKA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "MiniMaxAI/MiniMax-M2.7", "messages": [{"role": "user", "content": "What is Gonka?"}] }' ``` ### Anthropic SDK ```python import os import anthropic client = anthropic.Anthropic( base_url="https://gate.joingonka.ai", api_key=os.environ["JOINGONKA_API_KEY"], ) message = client.messages.create( model="MiniMaxAI/MiniMax-M2.7", max_tokens=1024, messages=[{"role": "user", "content": "What is Gonka?"}], ) print(message.content[0].text) ``` ## ドキュメントセクション - [API](https://gate.joingonka.ai/ja/docs/api) — Gonka ネットワークのモデルを利用する OpenAI および Anthropic 互換 API のリファレンス：キー、パラメータ、ストリーミング、ツール、プラグイン。登録時には無料トークンも進呈。 - [モデル](https://gate.joingonka.ai/ja/docs/models) — Gonka ネットワークのモデルをひとつの API に：model フィールド用の id、コンテキスト、出力上限、料金、ステータス。同じオープンモデルを桁違いに安く。 - [エラーと制限](https://gate.joingonka.ai/ja/docs/errors) — ゲートウェイのエラーコード、リクエスト制限、タイムアウト：各レスポンスの意味と、リクエストを再試行すべきタイミングを解説。 - [料金とアカウント](https://gate.joingonka.ai/ja/docs/billing) — Gonka ネットワークのモデルをトークン単価で：始められる無料トークン、GNK・USDT・カードでのチャージ、すべて公開された手数料、そして支出を管理できるアカウント API。 - [エージェント向け](https://gate.joingonka.ai/ja/docs/agents) — リンクを AI エージェントに渡すだけ。Claude Code、Cursor、Codex を Gonka ネットワークのモデルに自動で接続します：すぐ使えるプロンプト、ガイド、スキルを用意。