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": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    "messages": [
      {"role": "user", "content": "Gonka کیا ہے؟"}
    ]
  }'

سٹریمنگ (حصوں میں جواب):

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-آپ کی کلید" \
  -d '{
    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    "messages": [
      {"role": "user", "content": "Python میں ہیلو ورلڈ لکھو"}
    ],
    "stream": true
  }'

جواب JSON فارمیٹ میں (عام) یا Server-Sent Events (سٹریمنگ) آتا ہے — مکمل طور پر 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="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    messages=[
        {"role": "user", "content": "بلاک چین کو سادہ الفاظ میں سمجھاو"}
    ],
)

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

سٹریمنگ:

stream = client.chat.completions.create(
    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    messages=[{"role": "user", "content": "پائتھن میں ایک چھانٹنے کا الگورتھم لکھو"}],
    stream=True,
)

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

ٹول کالنگ:

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="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    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}")

Qwen3-235B مقامی ٹول کالنگ کو سپورٹ کرتا ہے — فنکشنز ٹیکسٹ رسپانس کو پارس کیے بغیر صحیح طریقے سے کال کیے جاتے ہیں۔

انسٹالیشن:

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: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',
    messages: [
      { role: 'user', content: 'ایک Express.js سرور لکھیں' },
    ],
  });

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

main();

سٹریمنگ:

const stream = await client.chat.completions.create({
  model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',
  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);
}

ٹول کالنگ:

const response = await client.chat.completions.create({
  model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',
  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 کے تمام معیاری پیرامیٹرز کو سپورٹ کرتا ہے:

Qwen3-235B ماڈل پیرامیٹرز: سیاق و سباق کی کھڑکی – 128K ٹوکنز، زیادہ سے زیادہ جواب – 2048 ٹوکنز۔ مکمل تفصیلات: HuggingFace۔ ماڈلز کی فہرست 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 فارمیٹ کے ذریعے براہ راست جوڑا جاتا ہے۔