API เริ่มต้นอย่างรวดเร็ว — curl, Python, TypeScript

วิธีที่เร็วที่สุดในการตรวจสอบการทำงานของ API คือใช้ curl:

คำขอปกติ (Standard request):

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-ваш-ключ" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "user", "content": "Gonka คืออะไร?"}
    ]
  }'

Streaming (ทยอยตอบเป็นส่วนๆ):

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-ваш-ключ" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "user", "content": "เขียน hello world ด้วย Python"}
    ],
    "stream": true
  }'

การตอบกลับจะอยู่ในรูปแบบ JSON (ปกติ) หรือ Server-Sent Events (streaming) ซึ่งรองรับการใช้งานร่วมกับ OpenAI API ได้อย่างสมบูรณ์แบบ

OpenAI Python SDK อย่างเป็นทางการทำงานได้กับ JoinGonka Gateway โดยไม่ต้องแก้ไข:

pip install openai

คำขอทั่วไป:

from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="jg-your-key",
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[
        {"role": "user", "content": "อธิบายบล็อกเชนด้วยคำง่ายๆ"}
    ],
)

print(response.choices[0].message.content)

Streaming:

stream = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "เขียนโค้ดเรียงลำดับใน Python"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Tool calling:

import json

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "รับสภาพอากาศในเมือง",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "ชื่อเมือง"}
            },
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "อากาศในมอสโกเป็นอย่างไร?"}],
    tools=tools,
)

tool_call = response.choices[0].message.tool_calls[0]
print(f"ฟังก์ชัน: {tool_call.function.name}")
print(f"อาร์กิวเมนต์: {tool_call.function.arguments}")

Kimi K2.6 รองรับ Native tool calling โดยฟังก์ชันจะถูกเรียกอย่างถูกต้องโดยไม่ต้องมีการวิเคราะห์คำตอบที่เป็นข้อความ

การติดตั้ง:

npm install openai

การเรียกใช้งานปกติ:

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://gate.joingonka.ai/v1',
  apiKey: 'jg-your-key',
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'MiniMaxAI/MiniMax-M2.7',
    messages: [
      { role: 'user', content: 'เขียนเซิร์ฟเวอร์ Express.js' },
    ],
  });

  console.log(response.choices[0].message.content);
}

main();

Streaming:

const stream = await client.chat.completions.create({
  model: 'MiniMaxAI/MiniMax-M2.7',
  messages: [{ role: 'user', content: 'อธิบายเรื่อง async/await' }],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content || '';
  process.stdout.write(content);
}

Tool calling:

const response = await client.chat.completions.create({
  model: 'MiniMaxAI/MiniMax-M2.7',
  messages: [{ role: 'user', content: 'แปลงเงิน 100 USD เป็น EUR' }],
  tools: [{
    type: 'function',
    function: {
      name: 'convert_currency',
      description: 'แปลงสกุลเงิน',
      parameters: {
        type: 'object',
        properties: {
          amount: { type: 'number' },
          from: { type: 'string' },
          to: { type: 'string' },
        },
        required: ['amount', 'from', 'to'],
      },
    },
  }],
});

const toolCall = response.choices[0].message.tool_calls?.[0];
console.log(`ฟังก์ชัน: ${toolCall?.function.name}`);
console.log(`อาร์กิวเมนต์: ${toolCall?.function.arguments}`);

ตัวอย่างทั้งหมดใช้ OpenAI SDK อย่างเป็นทางการ โดยไม่ต้องใช้ไลบรารีเพิ่มเติม เพียงแค่เปลี่ยน base_url และ api_key เท่านั้น

JoinGonka Gateway รองรับพารามิเตอร์ OpenAI Chat Completions API มาตรฐานทั้งหมด:

พารามิเตอร์โมเดลในเครือข่าย: หน้าต่างบริบท — 200K โทเค็น, คำตอบสูงสุด — สูงสุด 8192 โทเค็น (สำหรับโมเดลทั้งหมดในเครือข่าย) รายการโมเดลสามารถดูได้ผ่าน GET /v1/models

สองเอ็นด์พอยต์:

• รูปแบบ OpenAI: POST https://gate.joingonka.ai/v1/chat/completions
• รูปแบบ Anthropic: POST https://gate.joingonka.ai/v1/messages

การตรวจสอบสิทธิ์: Authorization: Bearer jg-your-key (OpenAI) หรือ x-api-key: jg-your-key (Anthropic)

รูปแบบการตอบกลับเข้ากันได้เต็มรูปแบบกับ OpenAI และ Anthropic — SDK, ไลบรารี หรือเฟรมเวิร์กใดก็ตามที่รองรับ OpenAI หรือ Anthropic API สามารถทำงานร่วมกับ JoinGonka Gateway ได้โดยไม่ต้องปรับแต่ง Claude Code เชื่อมต่อผ่านรูปแบบ Anthropic ได้โดยตรง