JoinGonka Gateway — 전체 개요

JoinGonka Gateway는 귀하의 애플리케이션과 Gonka 네트워크 사이의 중간 계층입니다. 아키텍처는 다음과 같습니다:

1. 귀하의 애플리케이션이 gate.joingonka.ai/v1/chat/completions(OpenAI 형식) 또는 gate.joingonka.ai/v1/messages(Anthropic 형식)로 요청을 보냅니다.
2. Gateway는 두 형식 중 하나로 요청을 받아 API 키와 잔액을 확인한 후, Gonka 네트워크로 전달합니다.
3. Gonka 네트워크는 선택된 모델(MiniMax M2.7, DeepSeek V4 Flash, GLM-5.3 Flash 등)이 배포된 ML 노드에서 요청을 처리합니다.
4. Gateway는 응답을 받아 소비된 토큰을 계산하고 잔액을 차감한 뒤, 요청받은 것과 동일한 형식(OpenAI 또는 Anthropic)으로 귀하의 애플리케이션에 응답을 반환합니다.

두 가지 API 형식: Gateway는 OpenAI Chat Completions API(/v1/chat/completions)와 Anthropic Messages API(/v1/messages)를 모두 지원합니다. 이는 Cursor나 LangChain 같은 도구는 OpenAI 형식으로 작동하고, Claude Code는 프록시나 변환기 없이 Anthropic 형식으로 직접 연결할 수 있음을 의미합니다.

Gonka 직접 API가 있는데 왜 Gateway가 필요한가요? Gonka 직접 API는 암호화폐 지갑, GNK 거래 서명, 그리고 블록체인에 대한 이해를 요구합니다. JoinGonka Gateway는 이러한 복잡함을 제거합니다. 편리한 통화(GNK, WGNK, USDT, 법정화폐)로 결제하고, 익숙한 OpenAI 또는 Anthropic 형식의 API를 사용하며, 대시보드로 모니터링할 수 있습니다. 암호화폐 지식은 전혀 필요하지 않습니다.

기술 스택: Fastify(Node.js), PostgreSQL, nginx. Gateway는 초당 최대 1000개의 요청을 처리하며, 스트리밍(두 형식 모두 SSE 지원), tool calling 및 모든 OpenAI Chat Completions + Anthropic Messages API 매개변수를 지원합니다. 지연 시간 증가분은 50ms 미만입니다.

전체 과정은 2분이면 끝납니다:

1. 가입: gate.joingonka.ai/register로 이동하세요. 이메일 + 비밀번호의 표준 양식입니다.
2. 보너스: 가입 시 3M 무료 토큰이 자동으로 지급됩니다. 이는 AI에 대한 수천 건의 요청에 해당하며, 테스트와 첫 통합에 충분합니다.
3. 키 생성: Dashboard → API Keys → Create Key. 키는 jg-로 시작하며, 예를 들어 jg-abc123def456과 같습니다. 한 번만 표시되니 반드시 저장하세요.
4. 첫 요청: OpenAI 또는 Anthropic 호환 클라이언트 어디서든 키를 사용하세요. OpenAI 형식의 경우 base_url을 https://gate.joingonka.ai/v1로 바꾸세요. Anthropic 형식(Claude Code)의 경우 ANTHROPIC_BASE_URL=https://gate.joingonka.ai입니다.

인기 도구를 위한 바로 사용 가능한 가이드: Cursor, Claude Code, Aider, Continue.dev, Cline, LangChain, n8n, Open WebUI, LibreChat. 코드 예제(curl, Python, TypeScript)는 API 빠른 시작에 있습니다.

Dashboard: 개인 페이지에서 현재 토큰 잔액, 요청 내역, 일별 사용량, API 키, 추천 링크를 확인할 수 있습니다. AI 비용 관리를 위한 완전한 CRM입니다.

Gonka 탈중앙화 네트워크에서 제공하는 오픈 모델들은 OpenRouter와 같은 일반적인 추론 플랫폼에서도 사용할 수 있습니다. 차이점은 가격입니다. 동일한 모델의 100만 토큰당 가격을 비교해 보겠습니다:

동일한 모델이 약 6~58배 더 저렴합니다. JoinGonka Gateway는 MiniMax-M2.7, DeepSeek-V4-Flash(네트워크 내에서 GLM-5.3-Flash의 390K에 이어 두 번째로 긴 380K 컨텍스트 제공), GLM-5.3-Flash를 100만 토큰당 약 $0.0069(입력) 및 약 $0.021(출력)에 제공합니다(출력은 다른 제공업체와 마찬가지로 3배 더 비쌉니다). 일반 플랫폼에서는 동일한 모델 가중치에 대해 약 6~58배 더 높은 비용이 발생합니다. 그 이유는 아키텍처 때문입니다. Gonka에서는 데이터 센터의 마진이 아닌 Proof of Useful Work를 통해 채굴자들에게 추론 비용을 지불하기 때문입니다.

가격뿐만이 아닙니다. JoinGonka Gateway는 OpenAI (/v1/chat/completions)와 Anthropic (/v1/messages) API 형식을 모두 제공하므로 Claude Code가 네이티브 Anthropic 형식을 통해 직접 연결할 수 있습니다. 또한, 네이티브 tool calling, 분석 기능이 포함된 대시보드, 유연한 결제 방식(GNK 0%, WGNK 1%, USDT 5%, 법정화폐) 및 추천 프로그램(L1 10% + L2 3%)을 지원합니다.

8가지 핵심 이점:

1. 가장 저렴한 OpenAI + Anthropic 호환 API: 100만 토큰당 $0.0069 — OpenAI GPT-5.5보다 약 720배 저렴합니다. 대부분의 작업에서 품질 차이는 미미하지만, 비용 면에서는 극적인 차이를 보입니다.
2. 두 가지 API 형식 — OpenAI 및 Anthropic: /v1/chat/completions (OpenAI)와 /v1/messages (Anthropic) 모두 하나의 키로 작동합니다. Cursor, LangChain, openai SDK는 OpenAI 형식으로, Claude Code는 Anthropic 형식을 통해 프록시 없이 직접 작동합니다. 이를 제공하는 경쟁사는 없습니다.
3. 네이티브 tool calling: 네트워크의 모든 모델은 OpenAI와 Anthropic 두 형식 모두에서 function calling을 지원합니다. 에이전트, 체인, 자동화가 모두 안정적으로 작동합니다.
4. 무료 시작: 가입 시 3M 토큰 제공. 결제 없이 몇 주간의 테스트와 첫 통합을 진행하기에 충분한 양입니다.
5. 유연한 결제: GNK(수수료 0%), Ethereum 기반 WGNK(1%), USDT(5%), On-Ramp를 통한 법정화폐 결제. 암호화폐를 몰라도 신용카드로 결제할 수 있습니다.
6. 추천 프로그램: 추천된 사용자의 소비액 중 10%(L1) + 그들의 추천 사용자의 소비액 중 3%(L2)를 환급받습니다. 링크를 공유하고 토큰을 적립하세요.
7. 대시보드 및 분석: 잔액, 소비량, 요청 기록, API 키 관리가 가능한 완전한 CRM 기능이 제공됩니다. 모든 것이 한곳에서 관리됩니다.
8. 생태계와의 완벽한 호환성: 모든 OpenAI 호환 클라이언트(Cursor, n8n, LangChain) 및 Anthropic 호환 클라이언트(Claude Code)에서 수정 없이 바로 작동합니다.

JoinGonka Gateway의 빌링은 GNK 토큰(내부 단위)으로 작동합니다:

• GNK 충전: 수수료 0%. GNK를 Gateway 주소로 보내면 잔액이 즉시 적립됩니다.
• WGNK 충전: 수수료 1%. Ethereum 네트워크상의 GNK의 경우, 송금이 자동으로 적립됩니다.
• USDT 충전: 수수료 5%. USDT(OxaPay 경유)로 결제하면 Gateway가 자동으로 GNK로 환전합니다. 5%는 편리함에 대한 수수료입니다(Gonka 암호화폐 지갑이 필요하지 않습니다).
• 법정화폐 충전: On-Ramp(카드 → USDT → GNK) 경유. 수수료는 On-Ramp 제공업체에 따라 다릅니다.

플랫폼 수수료: Gonka 네트워크 내 기본 추론 비용에 10%의 수수료가 적용됩니다. 이 수수료는 최종 가격인 ~$0.0069/1M 토큰에 이미 포함되어 있습니다. 네트워크 내 기본 비용은 약 ~$0.0046/1M이며, 수수료 포함 시 ~$0.0069/1M입니다. 수수료는 Gateway 인프라 비용(서버, DB, 모니터링)을 충당합니다.

사용량 계산 방법: API에 대한 각 요청(OpenAI 포맷 및 Anthropic 포맷 모두)은 단일 잔액에서 토큰을 차감합니다. Gateway는 prompt_tokens(입력) + completion_tokens(출력)를 계산하여 잔액에서 차감합니다. 비용: 1M 토큰당 $0.0069(현재 환율 기준 약 0.003 GNK). 두 API 포맷 모두 하나의 키, 하나의 잔액으로 관리됩니다.

Tool calling: 함수 호출(tools) 역시 토큰을 소비합니다. 함수 정의가 프롬프트에 추가되기 때문입니다. 일반적인 tool calling 요청은 일반 요청보다 1.5~3배 많은 토큰을 소비하지만, $0.0069/1M 가격이라면 여전히 매우 저렴합니다.

리퍼럴 프로그램: 각 사용자는 Dashboard에서 고유한 추천 링크를 받을 수 있습니다. 초대한 사용자가 토큰을 소비하면 소비액의 10%(L1)를 받습니다. 추천받은 사용자가 또 다른 사용자를 초대하면 그 소비액의 3%(L2)를 받습니다. 리퍼럴 수익은 GNK 토큰으로 잔액에 적립됩니다.

투명성: 충전, 차감, 리퍼럴 수익 등 모든 거래 내역은 Dashboard에서 확인할 수 있습니다. API는 응답마다 usage 객체를 반환하므로, 요청 시 토큰이 얼마나 소비되었는지 항상 파악할 수 있습니다.

모델 파라미터: 컨텍스트 윈도우는 MiniMax M2.7에서 200K 토큰, DeepSeek V4 Flash에서 380K 토큰, GLM-5.3 Flash에서 390K 토큰입니다. 최대 응답 길이는 8192 토큰까지입니다(DeepSeek V4 Flash는 최대 32768까지; max_tokens 미지정 시 기본값은 1500). 지원되는 API 파라미터: model, messages, max_tokens, temperature, tools, tool_choice, stream.