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-प्रारूप के माध्यम से जुड़ता है।