اپنی پہلی API درخواست بنائیں
ایک ShareAI API کلید بنائیں، ایک دستیاب ماڈل منتخب کریں اور اپنے سرور سے Bearer تصدیق کے ساتھ چیٹ درخواست بھیجیں۔
اس صفحے پر
یہاں سے شروع کریں جب آپ کی ایپلیکیشن اپنی ShareAI ورک اسپیس سے API کلید استعمال کرتے ہوئے درخواستیں کرے گی۔ آپ کو ایک ShareAI اکاؤنٹ، ایک فعال کلید اور اس ماڈل تک رسائی کی ضرورت ہے جسے آپ چلانا چاہتے ہیں۔
1. ایک API کلید بنائیں#
کھولیں شیئر اے آئی کنسول اور اس ورک اسپیس کو منتخب کریں جو کلید اور استعمال کی مالک ہوگی۔ کھولیں API کیز, منتخب کریں API کلید بنائیں، کلید کو ایک پہچاننے والا نام دیں اور اپنے سرور ماحول میں خفیہ محفوظ کریں۔


2. ایک ماڈل منتخب کریں#
کھولیں ماڈلز اور وہاں دکھائے گئے عین ماڈل شناخت کنندہ کو کاپی کریں۔ موجودہ دستیابی اور آپ کی کلید پر ماڈل/پرووائیڈر کی پابندیوں کو چیک کریں۔ کسی پرانے ٹیوٹوریل میں ایک شناخت کنندہ آج کی دستیابی کی ضمانت نہیں دیتا۔
3. درخواست بھیجیں#
https://api.shareai.now/api/v1/chat/completionsایک دستیاب ماڈل کا استعمال کرتے ہوئے جواب تیار کریں۔
- بیس URL
https://api.shareai.now- تصدیق
- Bearer API key
تبدیل کریں MODEL_IDENTIFIER اپنے منتخب کردہ شناخت کنندہ کے ساتھ۔ سیٹ کریں SHAREAI_API_KEY اپنے ماحول میں مثال چلانے سے پہلے۔
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": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"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': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], '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": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"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());
4. نتیجہ پڑھیں#
ایک کامیاب نان-اسٹریمنگ درخواست کے لیے، چیک کریں کہ done سچ ہے اور اسسٹنٹ پیغام کو پڑھیں message.content۔ HTTP اسٹیٹس اور باڈی میں کسی بھی خرابی کے آبجیکٹ کو چیک کریں اس سے پہلے کہ اسے کامیاب تکمیل کے طور پر سمجھیں۔ ایک نو-ڈیوائس نتیجہ فی الحال ایک خرابی کے آبجیکٹ کے طور پر HTTP 200 کے ساتھ آ سکتا ہے۔
اگر درخواست ناکام ہو#
| حیثیت | اگلا قدم |
|---|---|
| 401 | کلید، ورک اسپیس اور اجازت ہیڈر کو چیک کریں۔ |
| 402 | دستیاب کریڈٹس یا قابل اطلاق بیلنس کو چیک کریں۔ |
| 403 | اجازت شدہ ماڈلز اور پرووائیڈرز کو چیک کریں۔ |
| 429 | جب Retry-After موجود ہو تو انتظار کریں، پھر محدود تاخیر کے ساتھ دوبارہ کوشش کریں۔ |
| 503 | موجودہ صلاحیت یا سروس کی دستیابی کو چیک کریں؛ ایک ریٹری حد رکھیں۔ |
اگلے اقدامات#
چیٹ درخواست اور جواب حوالہ معاون باڈی کی وضاحت کرتا ہے۔ اگر ہر صارف کو اپنے اکاؤنٹ کو مجاز بنانا چاہیے، تو فالو کریں ایپلیکیشن OAuth.
آخری بار اپ ڈیٹ کیا گیا ستمبر 15, 2026