ஒரு உரை பதிலை உருவாக்கவும்
Stateless உரை உருவாக்கம், வெளிப்படையான உரையாடல் வரலாறு மற்றும் Responses ஸ்ட்ரீமிங் நிகழ்வுகளுக்கு ShareAI Responses API ஐப் பயன்படுத்தவும்.
இந்த பக்கத்தில்
https://api.shareai.now/api/v1/responsesஒரு ப்ராம்ட் அல்லது உரையாடலிலிருந்து உரை பதிலை உருவாக்கவும்.
- அடிப்படை URL
https://api.shareai.now- அங்கீகாரம்
- Bearer API முக்கியம் அல்லது அங்கீகரிக்கப்பட்ட OAuth அணுகல் டோக்கன்
உங்கள் பயன்பாடு Responses உரை-செய்தி வடிவத்தைப் பயன்படுத்தும்போது இந்த 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 | காலியாக இல்லாத string, அல்லது 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 டோக்கன் வரம்பைக் குறிக்கலாம். Public usage தற்போது null; Console 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 கணக்கு நிதியளிக்கப்பட்ட inference க்கு அளவுரு மற்றும் ஏற்றுக்கொள்ளப்பட்ட பயன்பாட்டு திட்டம் தேவை. அடையாளம் மட்டும் அளவுருக்கள் செலவினத்தை அங்கீகரிக்காது. பார்க்கவும் அளவுருக்கள் மற்றும் அனுமதிகள்.
கடைசியாக புதுப்பிக்கப்பட்டது செப்டம்பர் 15, 2026