ایک متن کا جواب تخلیق کریں
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 فی الحال 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