API त्वरित शुरुआत — curl, Python, TypeScript

API को टेस्ट करने का सबसे तेज़ तरीका है curl:

सामान्य रिक्वेस्ट:

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-your-key" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "user", "content": "What is Gonka?"}
    ]
  }'

Streaming (हिस्सों में जवाब):

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-your-key" \
  -d '{
    "model": "MiniMaxAI/MiniMax-M2.7",
    "messages": [
      {"role": "user", "content": "Write hello world in 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": "Explain blockchain in simple terms"}
    ],
)

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

Streaming:

stream = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "Write a sorting function in 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": "Get the weather in a city",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "City name"}
            },
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="MiniMaxAI/MiniMax-M2.7",
    messages=[{"role": "user", "content": "What is the weather in Moscow?"}],
    tools=tools,
)

tool_call = response.choices[0].message.tool_calls[0]
print(f"Function: {tool_call.function.name}")
print(f"Arguments: {tool_call.function.arguments}")

नेटवर्क के मॉडल नेटिव 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: 'Write an Express.js server' },
    ],
  });

  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: 'Explain 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: 'Convert 100 USD to EUR' }],
  tools: [{
    type: 'function',
    function: {
      name: 'convert_currency',
      description: 'Currency conversion',
      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(`Function: ${toolCall?.function.name}`);
console.log(`Arguments: ${toolCall?.function.arguments}`);

सभी उदाहरण ऑफ़िशियल OpenAI SDK का इस्तेमाल करते हैं — किसी अतिरिक्त लाइब्रेरी की ज़रूरत नहीं। बस base_url और api_key बदल दें।

JoinGonka Gateway सभी मानक OpenAI Chat Completions API पैरामीटर का समर्थन करता है:

नेटवर्क मॉडल के पैरामीटर: कॉन्टेक्स्ट विंडो — MiniMax M2.7 में 200K टोकन (DeepSeek V4 Flash में 380K, GLM-5.3 Flash में 390K), अधिकतम उत्तर — 8192 टोकन तक (DeepSeek V4 Flash में — 32768 तक)। मॉडल की सूची 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 के साथ पूरी तरह संगत है — OpenAI या Anthropic API का समर्थन करने वाला कोई भी SDK, लाइब्रेरी या फ़्रेमवर्क JoinGonka Gateway के साथ बिना किसी बदलाव के काम करता है। Claude Code सीधे Anthropic फ़ॉर्मेट के ज़रिए जुड़ता है।