ایک چیٹ مکمل بنائیں
Bearer API key کے ساتھ ShareAI چیٹ-کمپلیشنز کی درخواست بھیجیں اور سپورٹ شدہ ماڈل، پیغامات اور اسٹریم فیلڈز کو سمجھیں۔
اس صفحے پر
https://api.shareai.now/api/v1/chat/completionsمنتخب کردہ ماڈل کا استعمال کرتے ہوئے چیٹ کی درخواست چلائیں۔
- بیس URL
https://api.shareai.now- تصدیق
- Bearer API key
یہ درخواستوں کے لیے ڈیفالٹ انٹیگریشن راستہ ہے جو آپ کے API-key ورک اسپیس کے ذریعے ادا اور مجاز ہیں۔ کلید کے ماڈل اور فراہم کنندہ کی پابندیاں الاٹمنٹ پر لاگو ہوتی ہیں، بشمول اجازت شدہ فallback راستے۔
درخواست کا مواد#
| فیلڈ | قسم | مطلب |
|---|---|---|
model | سٹرنگ، ضروری | دستیاب ماڈل کی درست شناخت۔ اسے Models سے کاپی کریں۔ |
messages | ارے | گفتگو کے پیغامات جن میں کردار اور مواد شامل ہیں۔ |
stream | بولین | false ایک JSON نتیجہ واپس کرتا ہے؛ true سرور-بھیجے گئے ایونٹس کی درخواست کرتا ہے۔ |
ٹیکسٹ میسج مواد کا استعمال کریں۔ کردار جیسے system, user اور assistant گفتگو کے مطابق بھیجیں۔ گفتگو کی تاریخ شامل کریں جو آپ چاہتے ہیں کہ ماڈل استعمال کرے؛ یہ نہ سمجھیں کہ درخواستیں ایک محفوظ شدہ گفتگو کا اشتراک کرتی ہیں۔
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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': 'MODEL_IDENTIFIER', 'messages': [{'role': 'system', 'content': 'Be concise and helpful.'}, {'role': 'user', 'content': 'Give me three ideas for a local community event.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', 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/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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());
جواب#
ایک مکمل غیر-اسٹریم نتیجہ done true پر سیٹ ہوتا ہے اور پیدا شدہ متن کو message.content. پر واپس کرتا ہے۔ اعلی سطح پر بھی done_reason اور consumption_type. شامل ہوتا ہے۔ اسٹریم ایک مختلف، چیٹ-کمپلیشن-چنک فارمیٹ استعمال کرتا ہے۔ یہ نہ سمجھیں کہ غیر-اسٹریم نتیجہ میں OpenAI-اسٹائل choices array شامل ہے۔
JSON
{
"done": true,
"done_reason": "stop",
"consumption_type": "credits",
"message": {
"role": "assistant",
"content": "Here are three ideas for your community event.",
"done": true,
"done_reason": "stop"
}
}
یہ ایک وضاحتی مکمل نتیجہ ہے؛ consumption_type اصل الاٹمنٹ موڈ کو بیان کرتا ہے۔ یہاں تک کہ جب HTTP اسٹیٹس 200 ہو، اعلی سطح کی غلطی کے لیے چیک کریں۔ کوئی ڈیوائس نہ ہونے کا نتیجہ فی الحال error.code = no_device کے ساتھ HTTP 200 استعمال کرتا ہے۔
ماڈل اور فراہم کنندہ کی پابندیاں#
ایک کلید مخصوص ماڈلز اور عمل درآمد فراہم کنندگان تک محدود ہو سکتی ہے۔ اگر رسائی سے انکار کیا گیا ہو، تو کلید کی معلومات کا معائنہ کریں اور کنسول میں کلید کو صرف اس صورت میں اپ ڈیٹ کریں جب مالک ورک اسپیس اس رسائی کو دینے کا ارادہ رکھتا ہو۔
اسٹریم یا صارف کی اجازت#
آخری بار اپ ڈیٹ کیا گیا ستمبر 15, 2026