> 面向 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 客户端的基地址：`https://gate.joingonka.ai/v1` - Anthropic API 客户端的基地址，不含 `/v1`：`https://gate.joingonka.ai` - 密钥通过 `Authorization: Bearer jg-…` 或 `x-api-key: jg-…` 请求头传递 - 可用模型列表：`GET https://gate.joingonka.ai/v1/models` - 推荐模型：`MiniMaxAI/MiniMax-M2.7` ## 接入工具 选择你的工具——下方是专为它准备的三步操作。安装器能用一条命令配置下表所列工具（共 25 个），其余工具可参照指南接入。 ### 密钥 在 [gate.joingonka.ai](https://gate.joingonka.ai/register) 注册，并在个人中心创建密钥。 注册后立即可获得 3M 免费 token。 ### 接入 安装器会自动配置工具：以隐藏输入方式询问密钥，写入配置并验证连接。`--tool` 的值见下方工具表。 ```bash npx -y @joingonka/setup --tool --model MiniMaxAI/MiniMax-M2.7 ``` 或者交由 AI 智能体配置——把这段提示词发给它： ```text 请按照 https://gate.joingonka.ai/docs/agents.md 的说明，将 你的工具 接入 JoinGonka Gateway——Gonka 网络兼容 OpenAI 和 Anthropic 的 API。密钥我会自己提供：不要将其保存到仓库文件中，也不要修改全局环境变量。最后用一条简短请求验证连接，并告知结果。 ``` 每个工具的分步指南见下方表格中的链接。 ### 验证 账户余额——此请求不消耗 token： ```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/zh/knowledge/cursor/) | IDE | `--tool cursor` | | [Claude Code](https://joingonka.ai/zh/knowledge/claude-code/) | CLI 智能体 | `--tool claude-code` | | [OpenClaw](https://joingonka.ai/zh/knowledge/openclaw/) | CLI 智能体 | `--tool openclaw` | | [OpenCode](https://joingonka.ai/zh/knowledge/opencode/) | CLI 智能体 | `--tool opencode` | | [Continue](https://joingonka.ai/zh/knowledge/continue-dev/) | IDE | `--tool continue` | | [Cline](https://joingonka.ai/zh/knowledge/cline/) | IDE | `--tool cline` | | [Aider](https://joingonka.ai/zh/knowledge/aider/) | CLI 智能体 | `--tool aider` | | [LangChain](https://joingonka.ai/zh/knowledge/langchain/) | 框架 | — | | [n8n](https://joingonka.ai/zh/knowledge/n8n/) | 框架 | — | | [Open WebUI](https://joingonka.ai/zh/knowledge/open-webui/) | 聊天工具 | — | | [LibreChat](https://joingonka.ai/zh/knowledge/librechat/) | 聊天工具 | — | | [Hermes](https://joingonka.ai/zh/knowledge/hermes/) | CLI 智能体 | `--tool hermes` | | [Kilo Code](https://joingonka.ai/zh/knowledge/kilo-code/) | IDE | `--tool kilo` | | [Roo Code](https://joingonka.ai/zh/knowledge/roo-code/) | IDE | `--tool roo` | | [LlamaIndex](https://joingonka.ai/zh/knowledge/llamaindex/) | 框架 | — | | [PydanticAI](https://joingonka.ai/zh/knowledge/pydantic-ai/) | 框架 | — | | [Vercel AI SDK](https://joingonka.ai/zh/knowledge/vercel-ai-sdk/) | 框架 | — | | [TanStack AI](https://joingonka.ai/zh/knowledge/tanstack-ai/) | 框架 | — | | [ZCode](https://joingonka.ai/zh/knowledge/zcode/) | CLI 智能体 | `--tool zcode` | | [JetBrains](https://joingonka.ai/zh/knowledge/jetbrains/) | IDE | `--tool jetbrains` | | [Copilot BYOK](https://joingonka.ai/zh/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` | | [Zed](https://joingonka.ai/zh/knowledge/zed/) | IDE | `--tool zed` | | [Pi](https://joingonka.ai/zh/knowledge/pi/) | CLI 智能体 | `--tool pi` | | [Codex CLI](https://joingonka.ai/zh/knowledge/codex/) | CLI 智能体 | `--tool codex` | | [DeepSeek Harness](https://joingonka.ai/zh/knowledge/deepseek-harness/) | CLI 智能体 | — | | [MiniMax Code](https://joingonka.ai/zh/knowledge/minimax-code/) | CLI 智能体 | `--tool minimax-code` | | [Warp](https://joingonka.ai/zh/knowledge/warp/) | CLI 智能体 | — | | [Trae](https://joingonka.ai/zh/knowledge/trae/) | IDE | — | | [Cherry Studio](https://joingonka.ai/zh/knowledge/cherry-studio/) | 聊天工具 | — | | [omp (Oh My Pi)](https://joingonka.ai/zh/knowledge/omp/) | CLI 智能体 | `--tool omp` | | [OpenHands](https://joingonka.ai/zh/knowledge/openhands/) | CLI 智能体 | — | | [Qwen Code](https://joingonka.ai/zh/knowledge/qwen-code/) | CLI 智能体 | `--tool qwen-code` | | [Goose](https://joingonka.ai/zh/knowledge/goose/) | CLI 智能体 | `--tool goose` | | [Crush](https://joingonka.ai/zh/knowledge/crush/) | CLI 智能体 | `--tool crush` | | [Zoo Code](https://joingonka.ai/zh/knowledge/zoo-code/) | IDE | `--tool zoo` | | [Kimi Code](https://joingonka.ai/zh/knowledge/kimi-code/) | CLI 智能体 | `--tool kimi-code` | | [Factory Droid](https://joingonka.ai/zh/knowledge/factory-droid/) | CLI 智能体 | `--tool droid` | | [MiMo Code](https://joingonka.ai/zh/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/zh/docs/api) — 兼容 OpenAI 和 Anthropic 的 Gonka 网络模型 API 参考：密钥、参数、流式传输、工具、插件。注册即送免费 token。 - [模型](https://gate.joingonka.ai/zh/docs/models) — 一个 API 调用 Gonka 网络全部模型：model 字段的 id、上下文、输出上限、价格与状态。同样的开源模型，价格低至几十分之一。 - [错误与速率限制](https://gate.joingonka.ai/zh/docs/errors) — 网关错误码、请求限制与超时：每个响应代表什么，以及何时重试请求。 - [定价与账户](https://gate.joingonka.ai/zh/docs/billing) — Gonka 网络模型按 token 计价：新用户免费 token，支持 GNK、USDT 或银行卡充值，所有费用公开透明，并提供账户 API 用于追踪支出。 - [面向智能体](https://gate.joingonka.ai/zh/docs/agents) — 把链接交给 AI 智能体，它就能自动将 Claude Code、Cursor 或 Codex 接入 Gonka 网络的模型：现成的提示词、指南与技能。