درخواستهای چت را با OAuth ارسال کنید
از یک توکن دسترسی ShareAI OAuth تأییدشده برای تکمیلهای چت با تأمین مالی مشتری استفاده کنید و انقضای توکن، رضایت و مرزهای حساب را مدیریت کنید.
در این صفحه
این مسیر را زمانی انتخاب کنید که یک مشتری برنامه شما را برای استفاده از حساب ShareAI انتخابی خود تأیید کرده باشد. ابتدا کد تأیید با PKCE را کامل کنید و یک گرانت که شامل surcharge.
https://api.shareai.now/api/v1/chat/completionsاجرای استنتاج تحت توافقنامه برنامه پذیرفتهشده مشتری است، دریافت کنید.
- URL پایه
https://api.shareai.now- احراز هویت
- توکن دسترسی OAuth Bearer
- دامنه مورد نیاز
surcharge
cURL
curl --fail-with-body https://api.shareai.now/api/v1/chat/completions \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"model":"MODEL_IDENTIFIER","messages":[{"role":"user","content":"Hello!"}],"stream":false}'
توکن دسترسی در هدر Bearer قرار میگیرد.#
نقطه پایانی چت و بدنه درخواست مشابه جریان API-key هستند. تفاوت در اعتبارنامه و چرخه عمر تأیید آن است. یک توکن تازهسازی فقط به نقطه پایانی توکن ارسال میشود؛ یک توکن ID فقط برای ورود تأییدشده برنامه استفاده میشود.
چه کسی پرداخت میکند و کدام طرح اعمال میشود؟#
گرانت پذیرفتهشده حساب شخصی یا سازمانی انتخابشده، برنامه و طرح استفاده را شناسایی میکند. سرویس این مقادیر را از تأییدیه تعیین میکند. شناسه پرداختکننده، هزینه سازنده یا موضوع مشتری دیگر را در بدنه چت برای تغییر صورتحساب ارسال نکنید.
دسترسی را بدون از دست دادن رضایت تمدید کنید.#
وقتی توکن دسترسی منقضی میشود، از جریان تازهسازی در بکاند خود استفاده کنید و توکن تازهسازی جایگزین را ذخیره کنید. وقتی گرانت لغو شد یا رضایت جدیدی لازم بود، مشتری را از طریق جریان مرورگر دوباره متصل کنید.
مدیریت خطا#
| نتیجه | اقدام |
|---|---|
401 consent_required | از مشتری بخواهید دوباره متصل شود اگر تأییدیه دیگر معتبر نیست. |
403 | مجوز استنتاج اعطاشده و دسترسی به مدل/ارائهدهنده مجاز را بررسی کنید. |
429 | به Retry-After و محدودیتهای برنامه/حساب خود احترام بگذارید. |
503 temporarily_unavailable | یک خطای موقت سرویس نشان دهید؛ به مشتری نگویید که رضایت لغو شده است. |
آخرین بهروزرسانی سپتامبر 15, 2026