> 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개)를 한 명령으로 설정하고, 나머지는 가이드에 따라 연결합니다. ### 키 [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/ko/knowledge/cursor/) | IDE | `--tool cursor` | | [Claude Code](https://joingonka.ai/ko/knowledge/claude-code/) | CLI 에이전트 | `--tool claude-code` | | [OpenClaw](https://joingonka.ai/ko/knowledge/openclaw/) | CLI 에이전트 | `--tool openclaw` | | [OpenCode](https://joingonka.ai/ko/knowledge/opencode/) | CLI 에이전트 | `--tool opencode` | | [Continue](https://joingonka.ai/ko/knowledge/continue-dev/) | IDE | `--tool continue` | | [Cline](https://joingonka.ai/ko/knowledge/cline/) | IDE | `--tool cline` | | [Aider](https://joingonka.ai/ko/knowledge/aider/) | CLI 에이전트 | `--tool aider` | | [LangChain](https://joingonka.ai/ko/knowledge/langchain/) | 프레임워크 | — | | [n8n](https://joingonka.ai/ko/knowledge/n8n/) | 프레임워크 | — | | [Open WebUI](https://joingonka.ai/ko/knowledge/open-webui/) | 채팅 | — | | [LibreChat](https://joingonka.ai/ko/knowledge/librechat/) | 채팅 | — | | [Hermes](https://joingonka.ai/ko/knowledge/hermes/) | CLI 에이전트 | `--tool hermes` | | [Kilo Code](https://joingonka.ai/ko/knowledge/kilo-code/) | IDE | `--tool kilo` | | [Roo Code](https://joingonka.ai/ko/knowledge/roo-code/) | IDE | `--tool roo` | | [LlamaIndex](https://joingonka.ai/ko/knowledge/llamaindex/) | 프레임워크 | — | | [PydanticAI](https://joingonka.ai/ko/knowledge/pydantic-ai/) | 프레임워크 | — | | [Vercel AI SDK](https://joingonka.ai/ko/knowledge/vercel-ai-sdk/) | 프레임워크 | — | | [TanStack AI](https://joingonka.ai/ko/knowledge/tanstack-ai/) | 프레임워크 | — | | [ZCode](https://joingonka.ai/ko/knowledge/zcode/) | CLI 에이전트 | `--tool zcode` | | [JetBrains](https://joingonka.ai/ko/knowledge/jetbrains/) | IDE | `--tool jetbrains` | | [Copilot BYOK](https://joingonka.ai/ko/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` | | [Zed](https://joingonka.ai/ko/knowledge/zed/) | IDE | `--tool zed` | | [Pi](https://joingonka.ai/ko/knowledge/pi/) | CLI 에이전트 | `--tool pi` | | [Codex CLI](https://joingonka.ai/ko/knowledge/codex/) | CLI 에이전트 | `--tool codex` | | [DeepSeek Harness](https://joingonka.ai/ko/knowledge/deepseek-harness/) | CLI 에이전트 | — | | [MiniMax Code](https://joingonka.ai/ko/knowledge/minimax-code/) | CLI 에이전트 | `--tool minimax-code` | | [Warp](https://joingonka.ai/ko/knowledge/warp/) | CLI 에이전트 | — | | [Trae](https://joingonka.ai/ko/knowledge/trae/) | IDE | — | | [Cherry Studio](https://joingonka.ai/ko/knowledge/cherry-studio/) | 채팅 | — | | [omp (Oh My Pi)](https://joingonka.ai/ko/knowledge/omp/) | CLI 에이전트 | `--tool omp` | | [OpenHands](https://joingonka.ai/ko/knowledge/openhands/) | CLI 에이전트 | — | | [Qwen Code](https://joingonka.ai/ko/knowledge/qwen-code/) | CLI 에이전트 | `--tool qwen-code` | | [Goose](https://joingonka.ai/ko/knowledge/goose/) | CLI 에이전트 | `--tool goose` | | [Crush](https://joingonka.ai/ko/knowledge/crush/) | CLI 에이전트 | `--tool crush` | | [Zoo Code](https://joingonka.ai/ko/knowledge/zoo-code/) | IDE | `--tool zoo` | | [Kimi Code](https://joingonka.ai/ko/knowledge/kimi-code/) | CLI 에이전트 | `--tool kimi-code` | | [Factory Droid](https://joingonka.ai/ko/knowledge/factory-droid/) | CLI 에이전트 | `--tool droid` | | [MiMo Code](https://joingonka.ai/ko/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/ko/docs/api) — Gonka 네트워크 모델을 위한 OpenAI 및 Anthropic 호환 API 레퍼런스: 키, 파라미터, 스트리밍, 도구, 플러그인. 가입 시 무료 토큰 제공. - [모델](https://gate.joingonka.ai/ko/docs/models) — 하나의 API로 Gonka 네트워크 모델을 이용하세요: model 필드용 id, 컨텍스트, 응답 한도, 가격 및 상태. 동일한 오픈 모델을 훨씬 저렴하게. - [오류 및 한도](https://gate.joingonka.ai/ko/docs/errors) — 게이트웨이 오류 코드, 요청 한도 및 타임아웃: 각 응답의 의미와 재시도 시점을 안내합니다. - [요금제 및 계정](https://gate.joingonka.ai/ko/docs/billing) — 토큰당 가격으로 Gonka 네트워크 모델 이용: 시작 시 무료 토큰, GNK, USDT 또는 카드로 충전, 모든 수수료 공개 및 비용 추적용 계정 API. - [에이전트용](https://gate.joingonka.ai/ko/docs/agents) — AI 에이전트에게 링크를 전달하면 Claude Code, Cursor 또는 Codex를 Gonka 네트워크 모델에 자동으로 연결합니다: 바로 쓸 수 있는 프롬프트, 안내 및 스킬.