یک تکمیل چت ایجاد کنید
یک درخواست تکمیل چت ShareAI را با کلید API Bearer ارسال کنید و مدل، پیامها و فیلدهای جریان پشتیبانیشده را درک کنید.
در این صفحه
https://api.shareai.now/api/v1/chat/completionsیک درخواست چت را با استفاده از مدل انتخابشده اجرا کنید.
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer
این مسیر ادغام پیشفرض برای درخواستهایی است که توسط فضای کاری کلید API شما پرداخت و مجاز شدهاند. محدودیتهای مدل و ارائهدهنده کلید برای تخصیص اعمال میشود، از جمله مسیرهای جایگزین مجاز.
بدنه درخواست#
| فیلد | نوع | معنا |
|---|---|---|
model | رشته، الزامی | شناسه مدل موجود دقیق. آن را از مدلها کپی کنید. |
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 '{
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"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 = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, '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 = {
"provider": {
"sort": {
"by": "price",
"direction": "asc"
}
},
"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 است.
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 استفاده میکند.
محدودیتهای مدل و ارائهدهنده#
یک کلید ممکن است به مدلها و ارائهدهندگان اجرا خاص محدود شود. اگر دسترسی رد شد، اطلاعات کلید را بررسی کنید و کلید را در کنسول فقط در صورتی بهروزرسانی کنید که فضای کاری مالک قصد اعطای آن دسترسی را داشته باشد.
جریان یا مجوز مشتری#
یک پاسخ را جریان دهید · از یک توکن دسترسی OAuth استفاده کنید
هویت مدل و ارائهدهندگان اجرا#
شناسه دقیق مدل مبتنی بر سازنده را کپی کنید مدلها. زیرساخت را جداگانه با گزینه اختیاری انتخاب کنید provider شیء. پیشفرض ارائهدهندگان واجد شرایط را بر اساس قیمت، از کمترین به بیشترین رتبهبندی میکند. ارائهدهندگان را انتخاب کنید یا به مرجع کامل سیاست.
آخرین بهروزرسانی سپتامبر 16, 2026