یک تکمیل چت ایجاد کنید
یک درخواست تکمیل چت 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 '{
"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 است.
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 استفاده کنید
آخرین بهروزرسانی سپتامبر 15, 2026