Dành cho AI agent: hướng dẫn từng bước để thiết lập — /docs/agents.md, chỉ mục tài liệu — /llms.txt.

Kết nối các mô hình Gonka với công cụ của bạn

API tương thích OpenAI và Anthropic. Chọn công cụ của bạn — nhận lệnh cài đặt, prompt cho agent và bước kiểm tra.

Thông tin nhanh#

  • Base URL cho client OpenAI API: https://gate.joingonka.ai/v1
  • Base URL cho client Anthropic API, không có /v1: https://gate.joingonka.ai
  • Key được truyền trong header Authorization: Bearer jg-… hoặc x-api-key: jg-…
  • Danh sách mô hình khả dụng: GET https://gate.joingonka.ai/v1/models
  • Mô hình đề xuất: MiniMaxAI/MiniMax-M2.7

Kết nối công cụ#

Chọn công cụ của bạn — bên dưới là ba bước dành riêng cho nó. Trình cài đặt thiết lập bằng một lệnh cho các công cụ trong bảng bên dưới (25 công cụ), các công cụ còn lại kết nối theo hướng dẫn.

Claude Code

  1. Key

    Đăng ký tại gate.joingonka.ai và tạo key trong trang cá nhân. Ngay sau khi đăng ký, tài khoản sẽ được tặng 3M token miễn phí.

    Lấy API key
  2. Kết nối

    Trình cài đặt sẽ tự cấu hình Claude Code: hỏi key với nhập ẩn, ghi file config và kiểm tra kết nối bằng một request tới gateway.

    Bash
    npx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7

    Hoặc giao cho AI agent thiết lập — gửi cho nó prompt sau:

    Prompt cho agent
    Kết nối Claude Code với JoinGonka Gateway — API tương thích OpenAI và Anthropic của mạng Gonka — theo hướng dẫn tại https://gate.joingonka.ai/docs/agents.md. Tôi sẽ tự đưa key: đừng lưu key vào file trong repo và đừng thay đổi biến môi trường toàn cục. Cuối cùng, kiểm tra kết nối bằng một request ngắn và báo kết quả.

    Hướng dẫn từng bước: Claude Code.

  3. Kiểm tra

    Số dư tài khoản — request này không tốn token:

    cURL
    curl -s https://gate.joingonka.ai/api/balance \
      -H "Authorization: Bearer $JOINGONKA_API_KEY"

    Request ngắn tới mô hình — phản hồi với mã 200 nghĩa là mọi thứ đã được cấu hình:

    cURL
    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}'

Tất cả công cụ#

Công cụLoạiTrình cài đặt
CursorIDE--tool cursor
Claude CodeCLI agent--tool claude-code
OpenClawCLI agent--tool openclaw
OpenCodeCLI agent--tool opencode
ContinueIDE--tool continue
ClineIDE--tool cline
AiderCLI agent--tool aider
LangChainFramework—
n8nFramework—
Open WebUIChat—
LibreChatChat—
HermesCLI agent--tool hermes
Kilo CodeIDE--tool kilo
Roo CodeIDE--tool roo
LlamaIndexFramework—
PydanticAIFramework—
Vercel AI SDKFramework—
TanStack AIFramework—
ZCodeCLI agent--tool zcode
JetBrainsIDE--tool jetbrains
Copilot BYOKIDE--tool copilot-byok
ZedIDE--tool zed
PiCLI agent--tool pi
Codex CLICLI agent--tool codex
DeepSeek HarnessCLI agent—
MiniMax CodeCLI agent--tool minimax-code
WarpCLI agent—
TraeIDE—
Cherry StudioChat—
omp (Oh My Pi)CLI agent--tool omp
OpenHandsCLI agent—
Qwen CodeCLI agent--tool qwen-code
GooseCLI agent--tool goose
CrushCLI agent--tool crush
Zoo CodeIDE--tool zoo
Kimi CodeCLI agent--tool kimi-code
Factory DroidCLI agent--tool droid
MiMo CodeCLI agent--tool mimo-code

Ví dụ code#

Cùng một request qua OpenAI SDK, cURL và Anthropic SDK. Key được lấy từ biến môi trường 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)

Các mục tài liệu#

  • API — Tham chiếu API tương thích OpenAI và Anthropic cho các mô hình trên mạng Gonka: khóa, tham số, streaming, công cụ, plugin. Token miễn phí khi đăng ký.
  • Mô hình — Các mô hình mạng Gonka trong một API duy nhất: id cho trường model, ngữ cảnh, giới hạn phản hồi, giá và trạng thái. Cùng những mô hình mở với giá rẻ hơn nhiều lần.
  • Lỗi và giới hạn — Mã lỗi cổng, giới hạn yêu cầu và thời gian chờ: ý nghĩa của từng phản hồi và khi nào nên thử lại.
  • Bảng giá và tài khoản — Các mô hình mạng Gonka theo giá mỗi token: token miễn phí khi bắt đầu, nạp bằng GNK, USDT hoặc thẻ, mọi khoản phí đều công khai và API tài khoản để theo dõi chi phí.
  • Dành cho agent — Gửi liên kết cho AI agent — nó sẽ tự kết nối Claude Code, Cursor hoặc Codex với các mô hình trên mạng Gonka: prompt sẵn sàng, hướng dẫn và skill.