Khởi động nhanh API — curl, Python, TypeScript

Cách nhanh nhất để kiểm tra API là sử dụng curl:

Yêu cầu thông thường:

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 là gì?"}
    ]
  }'

Streaming (phản hồi theo phần):

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": "Hãy viết hello world bằng Python"}
    ],
    "stream": true
  }'

Phản hồi trả về ở định dạng JSON (thông thường) hoặc Server-Sent Events (streaming) — tương thích hoàn toàn với OpenAI API.

OpenAI Python SDK chính thức hoạt động với JoinGonka Gateway mà không cần thay đổi:

pip install openai

Yêu cầu thông thường:

from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="jg-ваш-ключ",
)

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[
        {"role": "user", "content": "Giải thích blockchain bằng ngôn ngữ đơn giản"}
    ],
)

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

Streaming:

stream = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "Viết mã sắp xếp bằng 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": "Lấy thời tiết tại thành phố",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "Tên thành phố"}
            },
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "Thời tiết ở Moscow thế nào?"}],
    tools=tools,
)

tool_call = response.choices[0].message.tool_calls[0]
print(f"Hàm: {tool_call.function.name}")
print(f"Đối số: {tool_call.function.arguments}")

Kimi K2.6 hỗ trợ tool calling gốc — các hàm được gọi chính xác mà không cần phân tích các phản hồi văn bản.

Cài đặt:

npm install openai

Yêu cầu thông thường:

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://gate.joingonka.ai/v1',
  apiKey: 'jg-ваш-ключ',
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'MiniMaxAI/MiniMax-M2.7',
    messages: [
      { role: 'user', content: 'Viết một máy chủ 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: 'Giải thích 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: 'Chuyển đổi 100 USD sang EUR' }],
  tools: [{
    type: 'function',
    function: {
      name: 'convert_currency',
      description: 'Chuyển đổi tiền tệ',
      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(`Hàm: ${toolCall?.function.name}`);
console.log(`Đối số: ${toolCall?.function.arguments}`);

Tất cả các ví dụ đều sử dụng OpenAI SDK chính thức — không yêu cầu thư viện bổ sung. Chỉ cần thay thế base_url và api_key.

JoinGonka Gateway hỗ trợ tất cả các tham số OpenAI Chat Completions API chuẩn:

Tham số mô hình mạng: cửa sổ ngữ cảnh — 200K token, phản hồi tối đa — lên đến 8192 token (cho tất cả mô hình trong mạng). Danh sách các mô hình có sẵn thông qua GET /v1/models.

Hai endpoint:

• OpenAI-format: POST https://gate.joingonka.ai/v1/chat/completions
• Anthropic-format: POST https://gate.joingonka.ai/v1/messages

Xác thực: Authorization: Bearer jg-ваш-ключ (OpenAI) hoặc x-api-key: jg-ваш-ключ (Anthropic)

Định dạng phản hồi hoàn toàn tương thích với OpenAI và Anthropic — bất kỳ SDK, thư viện hoặc framework nào hỗ trợ OpenAI hoặc Anthropic API đều hoạt động với JoinGonka Gateway mà không cần sửa đổi. Claude Code kết nối trực tiếp qua định dạng Anthropic.