दस्तावेज़API संदर्भ SDK संदर्भ एजेंटिक उपयोग AI स्किल्स

चैट

चैट बनाएँ

दी गई चैट बातचीत के लिए मॉडल प्रतिक्रिया का अनुरोध करता है। स्ट्रीमिंग और नॉन-स्ट्रीमिंग दोनों मोड समर्थित हैं, सभी मॉडल और प्रदाताओं में एक ही OpenAI-संगत अनुरोध/प्रतिक्रिया रूप के साथ।

POST/api/v1/chat/completions

प्राधिकरण

Authorizationआवश्यक

string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

Body

modelआवश्यक

string

उपयोग करने वाला मॉडल, प्रदाता-योग्य, जैसे "openai/gpt-4.1"। सामान्य मॉडल परिवारों के छोटे id (जैसे "gpt-4o") स्वतः पूर्ण canonical id ("openai/gpt-4o") में हल हो जाते हैं; पहले से canonical रूप के मान ज्यों के त्यों गुजरते हैं। अपरिचित छोटे id को जबरन नहीं बदला जाता — मॉडल रिज़ॉल्यूशन चरण स्पष्ट मॉडल-नहीं-मिला त्रुटि लौटाता है।

minLength: 1

Example: "openai/gpt-4.1"

messagesआवश्यक

Message[]

बातचीत संदेशों की सरणी, कम से कम एक। प्रत्येक में role (system/user/assistant/tool) और content होता है।

minLength: 1

models

string[]

फ़ॉलबैक मॉडल सूची — क्रम से आज़माई जाती है, केवल तब उपयोग होती है जब प्राइमरी मॉडल का अपना उम्मीदवार समूह समाप्त हो जाए।

stream

boolean

true होने पर प्रतिक्रिया SSE के रूप में स्ट्रीम होती है; छोड़ने या false पर एकल JSON प्रतिक्रिया मिलती है।

temperature

number

सैंपलिंग तापमान — जितना अधिक उतना यादृच्छिक, जितना कम उतना नियतात्मक।

0–2

max_tokens

integer

प्रतिक्रिया द्वारा जनरेट किए जा सकने वाले अधिकतम टोकन की संख्या।

max_completion_tokens

integer

max_tokens का उपनाम, समान अर्थ के साथ।

top_p

number

न्यूक्लियस सैंपलिंग थ्रेशोल्ड।

0–1

top_k

integer

सैंपलिंग को सबसे अधिक संभावना वाले K टोकन तक सीमित करता है।

frequency_penalty

number

टोकन को उनके पहले से आने की आवृत्ति के आधार पर दंडित करता है।

-2.0–2.0

presence_penalty

number

टोकन को इस आधार पर दंडित करता है कि वे कितनी बार भी आए हों, बिना गिनती के।

-2.0–2.0

repetition_penalty

number

पुनरावृत्ति दंड गुणांक — frequency/presence penalty से अलग तंत्र।

min_p

number

सबसे संभावित टोकन के सापेक्ष न्यूनतम संभावना सीमा।

0–1

top_a

number

एक और गतिशील कटऑफ सैंपलिंग तंत्र, जो शीर्ष संभावना के वर्ग से थ्रेशोल्ड को स्केल करता है।

seed

integer

नियतात्मक सैंपलिंग सीड; सभी प्रदाता पुनरुत्पादकता की गारंटी नहीं देते।

n

integer

जनरेट किए जाने वाले पूर्णताओं की संख्या।

stop

string | string[]

अनुक्रम जहाँ जनरेशन रुक जाता है, अधिकतम 4।

tools

Tool[]

टूल/फ़ंक्शन परिभाषाओं की सूची जिन्हें मॉडल कॉल कर सकता है।

tool_choice

string | object

नियंत्रित करता है कि मॉडल को टूल कॉल करने के लिए मजबूर किया जाए या नहीं/कैसे।

parallel_tool_calls

boolean

tools प्रदान किए जाने पर समानांतर टूल कॉल की अनुमति दें या नहीं। डिफ़ॉल्ट true। केवल OpenAI-परिवार मॉडल — जब लक्ष्य मॉडल OpenAI का न हो तो यह फ़ील्ड चुपचाप हटा दी जाती है, यह त्रुटि नहीं है।

response_format

object

आउटपुट फ़ॉर्मेट को सीमित करता है, जैसे {type:"json_object"} या JSON Schema के साथ {type:"json_schema"}।

logit_bias

object

टोकन ID को [-100, 100] बायस मानों से मैप करता है, जो सैंपलिंग से पहले जोड़े जाते हैं। केवल OpenAI-परिवार मॉडल — जब लक्ष्य मॉडल OpenAI का न हो तो यह फ़ील्ड चुपचाप हटा दी जाती है, यह त्रुटि नहीं है।

logprobs

boolean

प्रत्येक आउटपुट टोकन की लॉग संभावनाएँ लौटाता है। केवल OpenAI-परिवार मॉडल — जब लक्ष्य मॉडल OpenAI का न हो तो यह फ़ील्ड चुपचाप हटा दी जाती है, यह त्रुटि नहीं है।

top_logprobs

integer

प्रति स्थिति लौटाए जाने वाले सबसे संभावित टोकन की संख्या (logprobs: true आवश्यक)। केवल OpenAI-परिवार मॉडल — जब लक्ष्य मॉडल OpenAI का न हो तो यह फ़ील्ड चुपचाप हटा दी जाती है, यह त्रुटि नहीं है।

0–20

user

string

मॉनिटरिंग और दुरुपयोग पहचान के लिए एंड-यूज़र पहचानकर्ता। बिलिंग पर कोई प्रभाव नहीं। केवल OpenAI-परिवार मॉडल — जब लक्ष्य मॉडल OpenAI का न हो तो यह फ़ील्ड चुपचाप हटा दी जाती है, यह त्रुटि नहीं है।

reasoning

object

रीज़निंग-मॉडल थिंकिंग कंट्रोल ऑब्जेक्ट (जैसे {effort, max_tokens})।

reasoning_effort

string

reasoning.effort के लिए फ़्लैट संक्षिप्त फ़ील्ड।

lowmediumhigh

image_config

object

छवि जनरेशन/संपादन विकल्प (जब modalities में image शामिल हो तब उपयोग)।

modalities

string[]

अनुरोधित आउटपुट मोडैलिटी। image शामिल होने पर इमेज-जनरेशन डिस्पैच पथ से गुजरता है।

textimage

plugins

object[]

प्लगइन सरणी (जैसे वेब सर्च सक्षम करने हेतु {id:"web"})। केवल कुछ मॉडल रूट पर समर्थित, अन्यथा निष्प्रभावी; :online मॉडल वेरिएंट स्वतः {id:"web"} जोड़ता है, वह भी केवल समर्थित रूट पर।

POST /api/v1/chat/completions

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one paragraph."}]
  }'

प्रतिक्रिया उदाहरण

सफल। BazaarLink केवल दो फ़ील्ड सामान्य करता है — model, और provider फ़ील्ड को हटाना — बाकी अपस्ट्रीम प्रतिक्रिया ज्यों की त्यों अग्रेषित होती है, जिसमें native_finish_reason, system_fingerprint, और reasoning जैसे फ़ील्ड शामिल हैं जो केवल तभी मौजूद होते हैं जब वह प्रदाता उन्हें भरता है। usage.cost अपवाद है — हमेशा BazaarLink की अपनी निपटाई गई राशि, अपस्ट्रीम से भेजा गया मान नहीं।

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing leverages quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 74,
    "total_tokens": 102,
    "cost": 0.000648
  }
}