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": "পাইথনে হ্যালো ওয়ার্ল্ড লিখুন"}
    ],
    "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-আপনার-কী (OpenAI) অথবা x-api-key: jg-আপনার-কী (Anthropic)

রেসপন্স ফরম্যাট OpenAI এবং Anthropic এর সাথে সম্পূর্ণ সামঞ্জস্যপূর্ণ – যেকোনো SDK, লাইব্রেরি বা ফ্রেমওয়ার্ক যা OpenAI বা Anthropic API সমর্থন করে, JoinGonka Gateway এর সাথে কোনো পরিবর্তন ছাড়াই কাজ করে। Claude Code সরাসরি Anthropic ফরম্যাটের মাধ্যমে সংযুক্ত হয়।