درخواست‌های چت را با OAuth ارسال کنید

از یک توکن دسترسی ShareAI OAuth تأییدشده برای تکمیل‌های چت با تأمین مالی مشتری استفاده کنید و انقضای توکن، رضایت و مرزهای حساب را مدیریت کنید.

مشاهده به‌صورت Markdown

در این صفحه

این مسیر را زمانی انتخاب کنید که یک مشتری برنامه شما را برای استفاده از حساب ShareAI انتخابی خود تأیید کرده باشد. ابتدا کد تأیید با PKCE را کامل کنید و یک گرانت که شامل surcharge.

POST 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`	یک خطای موقت سرویس نشان دهید؛ به مشتری نگویید که رضایت لغو شده است.

هویت مدل و ارائه‌دهندگان اجرا#

شناسه دقیق مدل مبتنی بر سازنده را کپی کنید مدل‌ها. زیرساخت را جداگانه با گزینه اختیاری انتخاب کنید provider شیء. پیش‌فرض ارائه‌دهندگان واجد شرایط را بر اساس قیمت، از کمترین به بیشترین رتبه‌بندی می‌کند. ارائه‌دهندگان را انتخاب کنید یا به مرجع کامل سیاست.

محدودیت‌های هزینه ماهانه و بازیابی صورتحساب#

هر حساب پرداختی می‌تواند محدودیت هزینه ماهانه خود را برای هر برنامه یا سرویس مشتری در بخش صورتحساب → اشتراک‌ها و تعهدات تنظیم کند. سقف شامل هزینه شبکه و هزینه اضافی سازنده می‌شود، در حالی که اشتراک‌های ثابت و خریدهای تأیید شده جداگانه باقی می‌مانند. خطای سقف از HTTP 402 استفاده می‌کند application_spending_limit_exceeded; اعتبارهای واجد شرایط ناکافی از HTTP 402 استفاده می‌کنند insufficient_credits. هر دو یک لینک صورتحساب مشتری ارائه می‌دهند. مثال قرارداد خطا، مدیریت جریان و یکپارچه‌سازی.

آخرین به‌روزرسانی سپتامبر 18, 2026