AI 에이전트용: 단계별 설정 안내 — /docs/agents.md, 문서 인덱스 — /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개)를 한 명령으로 설정하고, 나머지는 가이드에 따라 연결합니다.
Claude Code
키
gate.joingonka.ai에 가입하고 마이페이지에서 키를 생성하세요. 가입 직후 3M 무료 토큰이 계정에 지급됩니다.
API 키 받기연결
설치 프로그램이 Claude Code을(를) 자동으로 설정합니다. 키를 숨김 입력으로 요청하고, 설정 파일에 기록한 뒤 게이트웨이에 요청을 보내 연결을 확인합니다.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7또는 AI 에이전트에게 설정을 맡기세요. 아래 프롬프트를 보내면 됩니다:
에이전트용 프롬프트Claude Code을(를) JoinGonka Gateway — Gonka 네트워크의 OpenAI 및 Anthropic 호환 API — 에 https://gate.joingonka.ai/docs/agents.md 안내에 따라 연결해 주세요. 키는 제가 직접 제공하겠습니다. 저장소 파일에 저장하거나 전역 환경 변수를 변경하지 마세요. 마지막에 짧은 요청으로 연결을 확인하고 결과를 알려주세요.단계별 가이드: Claude Code.
확인
계정 잔액 — 이 요청은 토큰을 소모하지 않습니다:
cURLcurl -s https://gate.joingonka.ai/api/balance \ -H "Authorization: Bearer $JOINGONKA_API_KEY"모델에 보내는 짧은 요청 — 상태 코드 200이 반환되면 설정이 완료된 것입니다:
cURLcurl -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 | IDE | --tool cursor |
| Claude Code | CLI 에이전트 | --tool claude-code |
| OpenClaw | CLI 에이전트 | --tool openclaw |
| OpenCode | CLI 에이전트 | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | CLI 에이전트 | --tool aider |
| LangChain | 프레임워크 | — |
| n8n | 프레임워크 | — |
| Open WebUI | 채팅 | — |
| LibreChat | 채팅 | — |
| Hermes | CLI 에이전트 | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | 프레임워크 | — |
| PydanticAI | 프레임워크 | — |
| Vercel AI SDK | 프레임워크 | — |
| TanStack AI | 프레임워크 | — |
| ZCode | CLI 에이전트 | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | CLI 에이전트 | --tool pi |
| Codex CLI | CLI 에이전트 | --tool codex |
| DeepSeek Harness | CLI 에이전트 | — |
| MiniMax Code | CLI 에이전트 | --tool minimax-code |
| Warp | CLI 에이전트 | — |
| Trae | IDE | — |
| Cherry Studio | 채팅 | — |
| omp (Oh My Pi) | CLI 에이전트 | --tool omp |
| OpenHands | CLI 에이전트 | — |
| Qwen Code | CLI 에이전트 | --tool qwen-code |
| Goose | CLI 에이전트 | --tool goose |
| Crush | CLI 에이전트 | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | CLI 에이전트 | --tool kimi-code |
| Factory Droid | CLI 에이전트 | --tool droid |
| MiMo Code | CLI 에이전트 | --tool mimo-code |
코드 예제#
동일한 요청을 OpenAI SDK, cURL, Anthropic SDK로 보냅니다. 키는 환경 변수 JOINGONKA_API_KEY에서 가져옵니다.
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)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 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?"}]
}'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 — Gonka 네트워크 모델을 위한 OpenAI 및 Anthropic 호환 API 레퍼런스: 키, 파라미터, 스트리밍, 도구, 플러그인. 가입 시 무료 토큰 제공.
- 모델 — 하나의 API로 Gonka 네트워크 모델을 이용하세요: model 필드용 id, 컨텍스트, 응답 한도, 가격 및 상태. 동일한 오픈 모델을 훨씬 저렴하게.
- 오류 및 한도 — 게이트웨이 오류 코드, 요청 한도 및 타임아웃: 각 응답의 의미와 재시도 시점을 안내합니다.
- 요금제 및 계정 — 토큰당 가격으로 Gonka 네트워크 모델 이용: 시작 시 무료 토큰, GNK, USDT 또는 카드로 충전, 모든 수수료 공개 및 비용 추적용 계정 API.
- 에이전트용 — AI 에이전트에게 링크를 전달하면 Claude Code, Cursor 또는 Codex를 Gonka 네트워크 모델에 자동으로 연결합니다: 바로 쓸 수 있는 프롬프트, 안내 및 스킬.