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": "Python में hello world लिखें"}
    ],
    "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-ваш-ключ",
)

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 नेटिव टूल कॉलिंग का समर्थन करता है — फ़ंक्शन सही ढंग से कॉल किए जाते हैं, टेक्स्ट रिस्पॉन्स पार्स करने की आवश्यकता नहीं है।

इंस्टॉलेशन:

npm install openai

सामान्य अनुरोध:

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: '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-ваш-ключ (OpenAI) या x-api-key: jg-ваш-ключ (Anthropic)

उत्तर का प्रारूप OpenAI और Anthropic के साथ पूरी तरह से संगत है — कोई भी SDK, लाइब्रेरी या फ्रेमवर्क जो OpenAI या Anthropic API का समर्थन करता है, वह JoinGonka Gateway के साथ बिना किसी बदलाव के काम करता है। Claude Code सीधे Anthropic-प्रारूप के माध्यम से जुड़ता है।