اولین درخواست API خود را ارسال کنید
یک کلید API ShareAI ایجاد کنید، یک مدل موجود را انتخاب کنید و یک درخواست چت از سرور خود با احراز هویت Bearer ارسال کنید.
در این صفحه
از اینجا شروع کنید زمانی که برنامه شما درخواستها را با استفاده از یک کلید API از فضای کاری ShareAI خودتان ارسال خواهد کرد. شما به یک حساب ShareAI، یک کلید فعال و دسترسی به مدلی که میخواهید اجرا کنید نیاز دارید.
1. ایجاد یک کلید API#
باز کردن کنسول ShareAI و فضای کاری را انتخاب کنید که مالک کلید و استفاده خواهد بود. باز کنید کلیدهای API, ، انتخاب کنید ایجاد کلید API، به کلید یک نام قابل تشخیص بدهید و راز را در محیط سرور خود ذخیره کنید.


2. انتخاب یک مدل#
باز کردن مدلها و شناسه دقیق مدل نمایش داده شده در آنجا را کپی کنید. دسترسی فعلی و محدودیتهای مدل/ارائهدهنده روی کلید خود را بررسی کنید. یک شناسه در یک آموزش قدیمی تضمین نمیکند که ظرفیت امروز در دسترس باشد.
3. ارسال درخواست#
https://api.shareai.now/api/v1/chat/completionsبا استفاده از یک مدل موجود، یک پاسخ تولید کنید.
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer
جایگزین کنید 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 برابر با true باشد و پیام دستیار را از message.content. بخوانید. هم وضعیت HTTP و هم هر شیء خطا در بدنه را بررسی کنید قبل از اینکه آن را بهعنوان یک تکمیل موفقیتآمیز در نظر بگیرید. نتیجه بدون دستگاه ممکن است در حال حاضر بهصورت یک شیء خطا با HTTP 200 ارائه شود.
اگر درخواست شکست خورد#
| وضعیت | مرحله بعد |
|---|---|
| 401 | کلید، فضای کاری و هدر Authorization را بررسی کنید. |
| 402 | اعتبارهای موجود یا موجودی قابل اعمال را بررسی کنید. |
| 403 | مدلها و ارائهدهندگان مجاز را بررسی کنید. |
| 429 | در صورت وجود Retry-After منتظر بمانید، سپس با تأخیر محدود دوباره تلاش کنید. |
| 503 | ظرفیت فعلی یا دسترسی به خدمات را بررسی کنید؛ محدودیت تلاش را حفظ کنید. |
مراحل بعدی#
مرجع درخواست و پاسخ چت بدنه پشتیبانیشده را توضیح میدهد. اگر هر مشتری باید حساب خود را تأیید کند، دنبال کنید OAuth برنامه.
آخرین بهروزرسانی سپتامبر 15, 2026