एक टेक्स्ट प्रतिक्रिया बनाएँ
ShareAI Responses API का उपयोग करें स्टेटलेस टेक्स्ट जनरेशन, स्पष्ट बातचीत इतिहास और Responses स्ट्रीमिंग इवेंट्स के लिए।
इस पेज पर
https://api.shareai.now/api/v1/responsesएक प्रॉम्प्ट या बातचीत से टेक्स्ट प्रतिक्रिया उत्पन्न करें।
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API कुंजी या स्वीकृत OAuth एक्सेस टोकन
इस API को चुनें जब आपका एप्लिकेशन Responses टेक्स्ट-मैसेज फॉर्मेट का उपयोग करता है। प्रत्येक अनुरोध पर बातचीत प्रदान करें; प्रतिक्रियाओं को बाद में पुनर्प्राप्ति के लिए संग्रहीत नहीं किया जाता।
एक अनुरोध भेजें#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/responses" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_CHAT_MODEL', 'input': 'Explain semantic search in two sentences.', 'instructions': 'Use plain language.', 'store': False, 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/responses', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/responses";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
अनुरोध फ़ील्ड्स#
| फ़ील्ड | मूल्य |
|---|---|
model | एक उपलब्ध चैट मॉडल जो आपके क्रेडेंशियल द्वारा अनुमत है। |
input | एक गैर-खाली स्ट्रिंग, या अधिकतम 256 टेक्स्ट संदेश। |
instructions | वैकल्पिक सिस्टम निर्देश जो बातचीत से पहले जोड़े जाते हैं। |
store | false; प्रतिक्रियाओं को संग्रहीत करना असमर्थित है। |
stream | false JSON के लिए या true Responses SSE इवेंट्स के लिए। |
एक बातचीत जारी रखें#
पहले के संदेश भेजें input अगले उपयोगकर्ता संदेश के साथ। समर्थित भूमिकाएं हैं user, assistant, system और developer। डेवलपर निर्देश आंतरिक रूप से सिस्टम भूमिका का उपयोग करते हैं। संदेश सामग्री टेक्स्ट या input_text/output_text भाग हो सकती है।
JSON
{
"model": "YOUR_CHAT_MODEL",
"input": [
{
"role": "user",
"content": "What is semantic search?"
},
{
"role": "assistant",
"content": "It finds results by meaning rather than exact words."
},
{
"role": "user",
"content": "Give one example."
}
],
"store": false
}
परिणाम पढ़ें#
JSON प्रतिक्रिया एक response ऑब्जेक्ट है। सहायक टेक्स्ट को पढ़ें output[].content[] प्रकार के साथ प्रविष्टियों से output_text। प्रतिक्रिया स्थिति की जांच करें: completed एक समाप्त प्रतिक्रिया है; incomplete एक टोकन सीमा का संकेत दे सकता है। सार्वजनिक usage वर्तमान में शून्य है; संसाधित उपयोग का निरीक्षण करने के लिए कंसोल उपयोग का उपयोग करें।
एक प्रतिक्रिया स्ट्रीम करें#
सेट करें stream: true और SSE को पार्स करें। इवेंट्स में शामिल हैं response.created, response.output_text.delta और एक टर्मिनल response.completed, response.incomplete या response.failed। टेक्स्ट डेल्टास को क्रम में जोड़ें और टर्मिनल स्थिति को स्पष्ट रूप से संभालें।
समर्थित उपसमूह#
यह एंडपॉइंट टेक्स्ट जनरेशन का समर्थन करता है। संग्रहीत प्रतिक्रियाएं, previous_response_id, पुनः प्राप्ति/हटाना, उपकरण, छवि इनपुट, पृष्ठभूमि अनुरोध और जेनरेशन सेटिंग्स जैसे temperature असमर्थित और अस्वीकार किए गए हैं। संदेश-आधारित जेनरेशन सेटिंग्स के लिए जो Chat Completions द्वारा समर्थित हैं, उपयोग करें चैट पूर्णता.
एक OAuth एक्सेस टोकन का उपयोग करें#
Authorization हेडर में API कुंजी को स्वीकृत OAuth एक्सेस टोकन से बदलें। surcharge खाता-वित्त पोषित इनफेरेंस के लिए स्कोप और स्वीकृत उपयोग योजना आवश्यक है। केवल पहचान स्कोप खर्च को अधिकृत नहीं करते। देखें स्कोप और अनुमतियां.
अंतिम अपडेट सितम्बर 15, 2026