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

Responses API

रिस्पॉन्स बनाएँ

OpenAI Responses API के अनुरोध रूप (input/instructions) का उपयोग करके मॉडल प्रतिक्रिया का अनुरोध करता है; आंतरिक रूप से Chat Completions प्रारूप में परिवर्तित होकर किसी भी समर्थित मॉडल पर रूट किया जाता है — यह एक अनुवाद परत है, अलग अनुमान पथ नहीं। यह एक स्टेटलेस एंडपॉइंट है: store: true या गैर-null previous_response_id भेजने पर 400 लौटता है (अलग त्रुटि रूप हेतु नीचे 400 प्रविष्टि देखें) — हर कॉल में input में पूरी बातचीत होनी चाहिए। स्ट्रीमिंग के दौरान, reasoning response.reasoning_text.delta इवेंट्स और type:"reasoning" आउटपुट आइटम के रूप में दिखाई देता है।

POST/api/v1/responses

प्राधिकरण

Authorizationआवश्यक

string · header

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

Body

modelआवश्यक

string

उपयोग करने वाला मॉडल, प्रदाता-योग्य, जैसे "openai/gpt-5.2"।

minLength: 1

Example: "openai/gpt-5.2"

inputआवश्यक

string | InputItem[]

बातचीत इनपुट — एकल स्ट्रिंग, या संरचित आइटम सरणी (message/function_call/function_call_output)। संदेश सादे टेक्स्ट या input_image सहित कंटेंट-ब्लॉक सरणी का उपयोग कर सकते हैं।

instructions

string

सिस्टम-स्तरीय निर्देश, परिवर्तित messages सरणी के सबसे आगे पहले system संदेश के रूप में डाले जाते हैं।

stream

boolean

true होने पर प्रतिक्रिया Responses API के SSE इवेंट्स (response.created, response.output_item.added, response.output_text.delta, response.reasoning_text.delta, response.completed, आदि) के रूप में स्ट्रीम होती है; छोड़ने या false पर एकल JSON प्रतिक्रिया मिलती है।

max_output_tokens

integer

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

tools

Tool[]

टूल/फ़ंक्शन परिभाषाओं की सूची जिन्हें मॉडल कॉल कर सकता है। Responses spec का फ़्लैट रूप {type:"function", name, description, parameters} (अनुशंसित) स्वीकार करता है, और Chat Completions का नेस्टेड रूप {type:"function", function:{...}} भी (बैक-कम्पैट के लिए स्वीकृत, ज्यों का त्यों भेजा जाता है)। प्रतिक्रिया ऑब्जेक्ट का tools फ़ील्ड यहाँ वास्तव में भेजे गए मान को दर्शाता है।

tool_choice

string | object

नियंत्रित करता है कि मॉडल को टूल कॉल करने के लिए मजबूर किया जाए या नहीं/कैसे, जैसे {type:"function", name:"..."} (फ़्लैट रूप, अनुशंसित, अपस्ट्रीम हेतु स्वतः परिवर्तित) या "auto"। प्रतिक्रिया ऑब्जेक्ट का tool_choice फ़ील्ड यहाँ भेजे गए मान को दर्शाता है, छोड़ने पर डिफ़ॉल्ट "auto" है।

parallel_tool_calls

boolean

tools प्रदान किए जाने पर समानांतर टूल कॉल की अनुमति दें या नहीं। छोड़ने पर डिफ़ॉल्ट true; प्रतिक्रिया ऑब्जेक्ट का parallel_tool_calls फ़ील्ड यहाँ भेजे गए मान को दर्शाता है।

plugins

object[]

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

store

boolean

⚠️ यह एंडपॉइंट स्टेटलेस है — true भेजने पर तुरंत 400 लौटता है, यह कभी स्वीकार या चुपचाप अनदेखा नहीं होता। इसे छोड़ना या false भेजना ही एकमात्र मान्य उपयोग है।

previous_response_id

string

⚠️ यह एंडपॉइंट स्टेटलेस है — कोई भी गैर-null मान भेजने पर तुरंत 400 लौटता है, यह कभी स्वीकार या चुपचाप अनदेखा नहीं होता। बातचीत जारी रखने के लिए, पूरा इतिहास input सरणी में भेजें।

models

string[]

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

reasoning

object

रीज़निंग-मॉडल थिंकिंग कंट्रोल ऑब्जेक्ट (जैसे {effort, max_tokens}), उसी रूप में अपस्ट्रीम भेजा जाता है — कोई डिफ़ॉल्ट मान नहीं जोड़ा जाता।

reasoning_effort

string

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

lowmediumhigh

thinking

object

Claude विस्तारित थिंकिंग का अतिरिक्त टोकन बजट (जैसे {type:"enabled", budget_tokens:2048}), max_output_tokens के ऊपर जोड़ा जाता है — उसी रूप में भेजा जाता है, कोई डिफ़ॉल्ट नहीं जोड़ा जाता।

enable_thinking

boolean

Qwen3 / GLM परिवार के मॉडल के लिए थिंकिंग ऑन/ऑफ टॉगल, उपयोगकर्ता की पसंद को उसी रूप में भेजा जाता है।

POST /api/v1/responses

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/responses \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.2",
    "input": "What is the capital of France?"
  }'

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

सफल। डिफ़ॉल्ट रूप से (या stream: false) नीचे दिया गया Response ऑब्जेक्ट लौटता है; stream: true पर इसके बजाय Responses API की SSE इवेंट स्ट्रीम मिलती है। model हमेशा आपके अनुरोधित नाम को दर्शाता है। output[] वास्तव में उत्पन्न हुई चीज़ों से बनता है: reasoning सामग्री होने पर पहले type:"reasoning" आइटम, फिर type:"message" टेक्स्ट आइटम (जिसके content के annotations सरणी में वेब सर्च हिट के url_citation जैसे उद्धरण स्रोत हो सकते हैं), या type:"function_call" आइटम। usage अंतर्निहित Chat Completions usage (input_tokens/output_tokens/total_tokens/cost) से परिवर्तित होता है, रीज़निंग टोकन उपयोग होने पर अतिरिक्त output_tokens_details.reasoning_tokens के साथ। tool_choice/tools/parallel_tool_calls अनुरोध में आपके द्वारा वास्तव में भेजे गए मान को दर्शाते हैं।

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
{
  "id": "resp_6f2a1c9d8e7b4a3f9c1d2e3f",
  "object": "response",
  "created_at": 1753500000,
  "completed_at": 1753500002,
  "status": "completed",
  "model": "openai/gpt-5.2",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_1a2b3c4d5e6f7a8b9c0d1e2f",
      "status": "completed",
      "summary": [],
      "content": [
        {
          "type": "reasoning_text",
          "text": "The user is asking a simple geography fact..."
        }
      ]
    },
    {
      "type": "message",
      "id": "msg_9f8e7d6c5b4a3f2e1d0c9b8a",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "The capital of France is Paris.",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 32,
    "total_tokens": 46,
    "cost": 0.00021,
    "output_tokens_details": {
      "reasoning_tokens": 18
    }
  },
  "error": null,
  "incomplete_details": null,
  "tool_choice": "auto",
  "tools": [],
  "truncation": "auto",
  "parallel_tool_calls": true,
  "metadata": {},
  "store": false
}