Endpoints

रिस्पॉन्स

POST /responses OpenAI Responses API फ़ॉर्मेट स्वीकार करता है। पैरामीटर, input आइटम, अनुरोध और प्रतिक्रिया का उदाहरण, और त्रुटि कोड यहाँ हैं।

playground में आज़माएं

Responses एंडपॉइंट OpenAI Responses API फ़ॉर्मेट स्वीकार करता है, इसलिए आधिकारिक SDK में client.responses.create(...) बिना बदलाव के काम करता है। यह चैट कंप्लीशन्स के ही मॉडल पर चलता है। api14 बॉडी को बिना बदले अपस्ट्रीम भेजता है और लौटे हुए usage का बिल बनाता है।

POST https://api14.com/api/v1/responses
Authorization: Bearer sk-api14-...
Content-Type: application/json

अनुरोध

पैरामीटर	प्रकार	विवरण
`model`	string, आवश्यक	मॉडल id, जैसे `openai/gpt-5-mini`।
`input`	string \| array, आवश्यक	प्रॉम्प्ट स्ट्रिंग या input आइटम का ऐरे (`{ role, content }` मैसेज, `function_call_output`, …)।
`instructions`	string	सिस्टम-स्तर के निर्देश।
`stream`	boolean	SSE पर सिमेंटिक इवेंट (`response.output_text.delta`, `response.completed`, …) स्ट्रीम करता है।
`max_output_tokens`	integer	जनरेट होने वाले टोकन की ऊपरी सीमा।
`temperature`, `top_p`	number	सैंपलिंग नियंत्रण।
`tools`, `tool_choice`, `parallel_tool_calls`		फ़ंक्शन टूल। वेब सर्च भी टूल के रूप में या `plugins` से उपलब्ध है।
`text`	object	आउटपुट फ़ॉर्मेट, जैसे `{ "format": { "type": "json_schema", "name": "...", "schema": {...} } }`।
`reasoning`	object	`{ "effort": "low" \| "medium" \| "high" }`। देखें रीज़निंग।
`provider`, `models`, `plugins`		चैट कंप्लीशन्स जैसे ही गेटवे एक्सटेंशन।

गेटवे आपकी बातचीत सहेजता नहीं है, इसलिए हर कॉल में पूरा कॉन्टेक्स्ट input में पास करें। previous_response_id जैसे स्टेटफ़ुल विकल्प समर्थित नहीं हो सकते।

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

ऊपर का उदाहरण चैट कंप्लीशन्स इस्तेमाल करता है। Node SDK के साथ Responses का समकक्ष ऐसा दिखता है:

const response = await client.responses.create({
  model: "openai/gpt-5-mini",
  input: "Write a haiku about APIs.",
});
console.log(response.output_text);

प्रतिक्रिया

{
  "id": "resp-1760000000-abc123",
  "object": "response",
  "created_at": 1760000000,
  "model": "openai/gpt-5-mini",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "Requests in flight,\nJSON answers drifting back,\none key opens all." }]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 22,
    "total_tokens": 36,
    "input_tokens_details": { "cached_tokens": 0 },
    "output_tokens_details": { "reasoning_tokens": 0 },
    "cost": 0.0000475
  }
}

गेटवे usage को अंतिम ऑब्जेक्ट से, या स्ट्रीमिंग में response.completed इवेंट से पढ़ता है, और cost को USD में आपके बैलेंस से काटता है।

त्रुटियाँ

चैट कंप्लीशन्स जैसी ही: 400 model_required, 400 invalid_json, 401 invalid_api_key, 402 insufficient_balance, 403 model_not_allowed / plan_required, 404 model_not_found, 413 payload_too_large, 429 rate_limited / daily_limit_reached, 502 upstream_unavailable। देखें त्रुटियाँ।