ส่งคำร้องขอแชทด้วย OAuth
ใช้ ShareAI OAuth access token ที่ได้รับการอนุมัติสำหรับการทำงานของแชทที่ลูกค้าเป็นผู้สนับสนุน และจัดการกับการหมดอายุของ token, การยินยอม และขอบเขตบัญชี.
ในหน้านี้
เลือกเส้นทางนี้เมื่อมีลูกค้าที่อนุญาตให้แอปพลิเคชันของคุณใช้บัญชี ShareAI ที่พวกเขาเลือก ก่อนอื่นให้ดำเนินการ authorization code พร้อม PKCE และรับ grant ที่รวมถึง surcharge.
https://api.shareai.now/api/v1/chat/completionsดำเนินการ inference ภายใต้ข้อตกลงแอปพลิเคชันที่ลูกค้ายอมรับ.
- Base URL → 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}'
Access token จะอยู่ใน Bearer header#
Chat endpoint และ request body จะเหมือนกับ API-key flow ความแตกต่างคือ credential และวงจรการอนุญาต Refresh token จะถูกส่งไปยัง token endpoint เท่านั้น ส่วน ID token จะใช้สำหรับการลงชื่อเข้าใช้แอปพลิเคชันที่ได้รับการตรวจสอบเท่านั้น.
ใครเป็นผู้จ่ายและแผนใดที่ใช้?#
Grant ที่ได้รับการยอมรับจะระบุบัญชีส่วนตัวหรือองค์กรที่เลือก แอปพลิเคชัน และแผนการใช้งาน บริการจะกำหนดค่าดังกล่าวจากการอนุญาต อย่าส่ง payer ID, builder fee หรือ subject ของลูกค้ารายอื่นใน chat body เพื่อเปลี่ยนการเรียกเก็บเงิน.
ต่ออายุการเข้าถึงโดยไม่สูญเสียการยินยอม#
เมื่อ access token หมดอายุ ให้ใช้ รีเฟรชโฟลว์ บน backend ของคุณและจัดเก็บ refresh token ที่เปลี่ยนใหม่ เมื่อ grant ถูกเพิกถอนหรือจำเป็นต้องได้รับการยินยอมใหม่ ให้เชื่อมต่อลูกค้าอีกครั้งผ่าน browser flow.
การจัดการข้อผิดพลาด#
| ผลลัพธ์ | การดำเนินการ |
|---|---|
401 consent_required | ขอให้ลูกค้าเชื่อมต่อใหม่หากการอนุญาตไม่ถูกต้องอีกต่อไป. |
403 | ตรวจสอบสิทธิ์การ inference ที่ได้รับและการเข้าถึง model/provider ที่อนุญาต. |
429 | เคารพ Retry-After และข้อจำกัดของแอปพลิเคชัน/บัญชีของคุณ. |
503 temporarily_unavailable | แสดงข้อผิดพลาดบริการชั่วคราว อย่าบอกลูกค้าว่าการยินยอมถูกเพิกถอน. |
ตัวตนของโมเดลและผู้ให้บริการการดำเนินการ#
คัดลอกตัวระบุโมเดลที่อิงตามผู้สร้างอย่างแม่นยำจาก โมเดล. เลือกโครงสร้างพื้นฐานแยกต่างหากด้วยตัวเลือก provider วัตถุ ค่าเริ่มต้นจัดอันดับผู้ให้บริการที่มีสิทธิ์ตามราคา โดยเริ่มจากราคาต่ำสุด. เลือกผู้ให้บริการ หรือปรึกษา การอ้างอิงนโยบายฉบับสมบูรณ์.
ขีดจำกัดการใช้จ่ายรายเดือนและการกู้คืนการเรียกเก็บเงิน#
แต่ละบัญชีที่ชำระเงินสามารถตั้งค่าขีดจำกัดการใช้จ่าย AI รายเดือนของตนเองต่อแอปพลิเคชันหรือบริการลูกค้าได้ใน Billing → Subscriptions & Commitments ขีดจำกัดนี้รวมถึงค่าใช้จ่ายเครือข่ายและค่าบริการของ Builder ในขณะที่การสมัครสมาชิกแบบคงที่และการซื้อที่ยืนยันแล้วจะถูกแยกออก ข้อผิดพลาดขีดจำกัดจะใช้ HTTP 402 application_spending_limit_exceeded; เครดิตที่มีสิทธิ์ไม่เพียงพอใช้ HTTP 402 insufficient_credits. ทั้งสองให้ลิงก์การเรียกเก็บเงินสำหรับลูกค้า. ตัวอย่างสัญญาข้อผิดพลาด การจัดการการสตรีม และการรวมระบบ.
อัปเดตล่าสุด กันยายน 18, 2026