मजकूर प्रतिसाद तयार करा
ShareAI प्रतिसाद API वापरा स्थिर मजकूर निर्मितीसाठी, स्पष्ट संभाषण इतिहासासाठी आणि प्रतिसाद प्रवाह इव्हेंटसाठी.
या पृष्ठावर
https://api.shareai.now/api/v1/responsesप्रॉम्प्ट किंवा संभाषणातून मजकूर प्रतिसाद तयार करा.
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API की किंवा मंजूर OAuth प्रवेश टोकन
तुमचे अॅप्लिकेशन प्रतिसाद मजकूर-संदेश स्वरूप वापरत असल्यास हा API निवडा. प्रत्येक विनंतीवर संभाषण पुरवा; प्रतिसाद नंतर पुनर्प्राप्तीसाठी संग्रहित केले जात नाहीत.
विनंती पाठवा#
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 प्रतिसाद 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 सध्या null आहे; प्रक्रिया केलेला वापर तपासण्यासाठी कन्सोल वापर वापरा.
प्रतिसाद प्रवाहित करा#
सेट करा 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