> สำหรับเอเจนต์ AI: คำแนะนำการตั้งค่าทีละขั้นตอน — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), ดัชนีเอกสาร — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# เชื่อมต่อโมเดล Gonka เข้ากับเครื่องมือของคุณ

API ที่เข้ากันได้กับ OpenAI และ Anthropic เลือกเครื่องมือของคุณ แล้วรับคำสั่งติดตั้ง พร้อมท์สำหรับเอเจนต์ และการตรวจสอบ

## ข้อมูลสำคัญโดยสรุป

- Base URL สำหรับไคลเอนต์ OpenAI API: `https://gate.joingonka.ai/v1`
- Base URL สำหรับไคลเอนต์ Anthropic API โดยไม่มี `/v1`: `https://gate.joingonka.ai`
- คีย์ส่งผ่านเฮดเดอร์ `Authorization: Bearer jg-…` หรือ `x-api-key: jg-…`
- รายการโมเดลที่ใช้ได้: `GET https://gate.joingonka.ai/v1/models`
- โมเดลที่แนะนำ: `MiniMaxAI/MiniMax-M2.7`

## เชื่อมต่อเครื่องมือ

เลือกเครื่องมือของคุณ แล้วทำตามสามขั้นตอนด้านล่างสำหรับเครื่องมือนั้น ตัวติดตั้งตั้งค่าเครื่องมือในตารางด้านล่างให้อัตโนมัติในคำสั่งเดียว (มี 25 รายการ) ส่วนที่เหลือเชื่อมต่อตามคู่มือ

### คีย์

สมัครที่ [gate.joingonka.ai](https://gate.joingonka.ai/register) แล้วสร้างคีย์ในหน้าบัญชีของคุณ ทันทีหลังสมัคร คุณจะได้รับ 3M โทเค็นฟรีเข้าบัญชี

### การเชื่อมต่อ

ตัวติดตั้งจะตั้งค่าเครื่องมือให้เอง: จะถามคีย์แบบซ่อนการพิมพ์ เขียนไฟล์คอนฟิก และทดสอบการเชื่อมต่อ ค่าสำหรับ `--tool` อยู่ในตารางเครื่องมือด้านล่าง

```bash
npx -y @joingonka/setup --tool <id> --model MiniMaxAI/MiniMax-M2.7
```

หรือมอบหมายการตั้งค่าให้เอเจนต์ AI — ส่งพรอมท์นี้ให้มัน:

```text
เชื่อมต่อ เครื่องมือของคุณ เข้ากับ JoinGonka Gateway ซึ่งเป็น API ของเครือข่าย Gonka ที่เข้ากันได้กับ OpenAI และ Anthropic โดยทำตามคำแนะนำที่ 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/th/knowledge/cursor/) | IDE | `--tool cursor` |
| [Claude Code](https://joingonka.ai/th/knowledge/claude-code/) | เอเจนต์ CLI | `--tool claude-code` |
| [OpenClaw](https://joingonka.ai/th/knowledge/openclaw/) | เอเจนต์ CLI | `--tool openclaw` |
| [OpenCode](https://joingonka.ai/th/knowledge/opencode/) | เอเจนต์ CLI | `--tool opencode` |
| [Continue](https://joingonka.ai/th/knowledge/continue-dev/) | IDE | `--tool continue` |
| [Cline](https://joingonka.ai/th/knowledge/cline/) | IDE | `--tool cline` |
| [Aider](https://joingonka.ai/th/knowledge/aider/) | เอเจนต์ CLI | `--tool aider` |
| [LangChain](https://joingonka.ai/th/knowledge/langchain/) | เฟรมเวิร์ก | — |
| [n8n](https://joingonka.ai/th/knowledge/n8n/) | เฟรมเวิร์ก | — |
| [Open WebUI](https://joingonka.ai/th/knowledge/open-webui/) | แชท | — |
| [LibreChat](https://joingonka.ai/th/knowledge/librechat/) | แชท | — |
| [Hermes](https://joingonka.ai/th/knowledge/hermes/) | เอเจนต์ CLI | `--tool hermes` |
| [Kilo Code](https://joingonka.ai/th/knowledge/kilo-code/) | IDE | `--tool kilo` |
| [Roo Code](https://joingonka.ai/th/knowledge/roo-code/) | IDE | `--tool roo` |
| [LlamaIndex](https://joingonka.ai/th/knowledge/llamaindex/) | เฟรมเวิร์ก | — |
| [PydanticAI](https://joingonka.ai/th/knowledge/pydantic-ai/) | เฟรมเวิร์ก | — |
| [Vercel AI SDK](https://joingonka.ai/th/knowledge/vercel-ai-sdk/) | เฟรมเวิร์ก | — |
| [TanStack AI](https://joingonka.ai/th/knowledge/tanstack-ai/) | เฟรมเวิร์ก | — |
| [ZCode](https://joingonka.ai/th/knowledge/zcode/) | เอเจนต์ CLI | `--tool zcode` |
| [JetBrains](https://joingonka.ai/th/knowledge/jetbrains/) | IDE | `--tool jetbrains` |
| [Copilot BYOK](https://joingonka.ai/th/knowledge/copilot-byok/) | IDE | `--tool copilot-byok` |
| [Zed](https://joingonka.ai/th/knowledge/zed/) | IDE | `--tool zed` |
| [Pi](https://joingonka.ai/th/knowledge/pi/) | เอเจนต์ CLI | `--tool pi` |
| [Codex CLI](https://joingonka.ai/th/knowledge/codex/) | เอเจนต์ CLI | `--tool codex` |
| [DeepSeek Harness](https://joingonka.ai/th/knowledge/deepseek-harness/) | เอเจนต์ CLI | — |
| [MiniMax Code](https://joingonka.ai/th/knowledge/minimax-code/) | เอเจนต์ CLI | `--tool minimax-code` |
| [Warp](https://joingonka.ai/th/knowledge/warp/) | เอเจนต์ CLI | — |
| [Trae](https://joingonka.ai/th/knowledge/trae/) | IDE | — |
| [Cherry Studio](https://joingonka.ai/th/knowledge/cherry-studio/) | แชท | — |
| [omp (Oh My Pi)](https://joingonka.ai/th/knowledge/omp/) | เอเจนต์ CLI | `--tool omp` |
| [OpenHands](https://joingonka.ai/th/knowledge/openhands/) | เอเจนต์ CLI | — |
| [Qwen Code](https://joingonka.ai/th/knowledge/qwen-code/) | เอเจนต์ CLI | `--tool qwen-code` |
| [Goose](https://joingonka.ai/th/knowledge/goose/) | เอเจนต์ CLI | `--tool goose` |
| [Crush](https://joingonka.ai/th/knowledge/crush/) | เอเจนต์ CLI | `--tool crush` |
| [Zoo Code](https://joingonka.ai/th/knowledge/zoo-code/) | IDE | `--tool zoo` |
| [Kimi Code](https://joingonka.ai/th/knowledge/kimi-code/) | เอเจนต์ CLI | `--tool kimi-code` |
| [Factory Droid](https://joingonka.ai/th/knowledge/factory-droid/) | เอเจนต์ CLI | `--tool droid` |
| [MiMo Code](https://joingonka.ai/th/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/th/docs/api) — เอกสารอ้างอิง API ที่เข้ากันได้กับ OpenAI และ Anthropic สำหรับโมเดลในเครือข่าย Gonka: คีย์ พารามิเตอร์ สตรีมมิ่ง เครื่องมือ ปลั๊กอิน รับโทเค็นฟรีเมื่อสมัคร
- [โมเดล](https://gate.joingonka.ai/th/docs/models) — โมเดลในเครือข่าย Gonka ใน API เดียว: id สำหรับฟิลด์ model, คอนเท็กซ์, ขีดจำกัดคำตอบ, ราคา และสถานะ โมเดลเปิดเดียวกันในราคาถูกกว่าหลายเท่า
- [ข้อผิดพลาดและขีดจำกัด](https://gate.joingonka.ai/th/docs/errors) — รหัสข้อผิดพลาดของเกตเวย์ ขีดจำกัดคำขอ และไทม์เอาต์: แต่ละคำตอบหมายถึงอะไร และเมื่อใดควรส่งคำขอซ้ำ
- [แพ็กเกจและบัญชี](https://gate.joingonka.ai/th/docs/billing) — โมเดลในเครือข่าย Gonka ในราคาต่อโทเค็น: โทเค็นฟรีเมื่อเริ่มต้น เติมเงินด้วย GNK, USDT หรือบัตร ค่าธรรมเนียมทั้งหมดโปร่งใส และ API บัญชีสำหรับติดตามค่าใช้จ่าย
- [สำหรับเอเจนต์](https://gate.joingonka.ai/th/docs/agents) — ส่งลิงก์ให้เอเจนต์ AI — มันจะเชื่อมต่อ Claude Code, Cursor หรือ Codex กับโมเดลในเครือข่าย Gonka เอง: พร้อมต์สำเร็จรูป คำแนะนำ และสกิล