ส่งคำร้องขอแชทด้วย 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 | แสดงข้อผิดพลาดบริการชั่วคราว อย่าบอกลูกค้าว่าการยินยอมถูกเพิกถอน. |
อัปเดตล่าสุด กันยายน 15, 2026