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ặcx-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
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 keyKế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.
Bashnpx -y @joingonka/setup --tool claude-code --model MiniMaxAI/MiniMax-M2.7Hoặc giao cho AI agent thiết lập — gửi cho nó prompt sau:
Prompt cho agentKế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.
Kiểm tra
Số dư tài khoản — request này không tốn token:
cURLcurl -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:
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}'
Tất cả công cụ#
| Công cụ | Loại | Trình cài đặt |
|---|---|---|
| Cursor | IDE | --tool cursor |
| Claude Code | CLI agent | --tool claude-code |
| OpenClaw | CLI agent | --tool openclaw |
| OpenCode | CLI agent | --tool opencode |
| Continue | IDE | --tool continue |
| Cline | IDE | --tool cline |
| Aider | CLI agent | --tool aider |
| LangChain | Framework | — |
| n8n | Framework | — |
| Open WebUI | Chat | — |
| LibreChat | Chat | — |
| Hermes | CLI agent | --tool hermes |
| Kilo Code | IDE | --tool kilo |
| Roo Code | IDE | --tool roo |
| LlamaIndex | Framework | — |
| PydanticAI | Framework | — |
| Vercel AI SDK | Framework | — |
| TanStack AI | Framework | — |
| ZCode | CLI agent | --tool zcode |
| JetBrains | IDE | --tool jetbrains |
| Copilot BYOK | IDE | --tool copilot-byok |
| Zed | IDE | --tool zed |
| Pi | CLI agent | --tool pi |
| Codex CLI | CLI agent | --tool codex |
| DeepSeek Harness | CLI agent | — |
| MiniMax Code | CLI agent | --tool minimax-code |
| Warp | CLI agent | — |
| Trae | IDE | — |
| Cherry Studio | Chat | — |
| omp (Oh My Pi) | CLI agent | --tool omp |
| OpenHands | CLI agent | — |
| Qwen Code | CLI agent | --tool qwen-code |
| Goose | CLI agent | --tool goose |
| Crush | CLI agent | --tool crush |
| Zoo Code | IDE | --tool zoo |
| Kimi Code | CLI agent | --tool kimi-code |
| Factory Droid | CLI agent | --tool droid |
| MiMo Code | CLI 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)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)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.