API فوری آغاز — curl, Python, TypeScript

API کو چیک کرنے کا تیز ترین طریقہ curl ہے:

عام ریکویسٹ:

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 میں ہیلو ورلڈ لکھو"}
    ],
    "stream": true
  }'

جواب JSON (عام) یا Server-Sent Events (streaming) فارمیٹ میں آتا ہے — جو مکمل طور پر OpenAI API کے ساتھ مطابقت رکھتا ہے۔

سرکاری OpenAI Python SDK بغیر کسی تبدیلی کے JoinGonka Gateway کے ساتھ کام کرتا ہے:

pip install openai

عام درخواست (Request):

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": "پائتھون میں سارٹنگ کوڈ لکھیں"}],
    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 مقامی طور پر tool calling کو سپورٹ کرتا ہے — فنکشنز صیح طریقے سے کال ہوتے ہیں، بغیر کسی ٹیکسٹ رسپانس پارسنگ کے۔

انسٹالیشن:

npm install openai

عام درخواست (Regular request):

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 کے ذریعے حاصل کی جا سکتی ہے۔

دو اینڈ پوائنٹس (Endpoint):

• OpenAI-فارمیٹ: POST https://gate.joingonka.ai/v1/chat/completions
• Anthropic-فارمیٹ: POST https://gate.joingonka.ai/v1/messages

توثیق (Authentication): Authorization: Bearer jg-ваш-ключ (OpenAI) یا x-api-key: jg-ваш-ключ (Anthropic)

رسپانس کا فارمیٹ OpenAI اور Anthropic کے ساتھ مکمل مشابہت رکھتا ہے — کوئی بھی SDK، لائبریری یا فریم ورک جو OpenAI یا Anthropic API کو سپورٹ کرتا ہے، وہ بغیر تبدیلی کے JoinGonka Gateway کے ساتھ کام کرتا ہے۔ Claude Code براہ راست Anthropic فارمیٹ کے ذریعے کنیکٹ ہوتا ہے۔