Gửi yêu cầu hội thoại với OAuth
Sử dụng một mã thông báo truy cập OAuth ShareAI đã được phê duyệt cho các hoàn thành trò chuyện do khách hàng tài trợ và xử lý hết hạn mã thông báo, sự đồng ý và ranh giới tài khoản.
Trên trang này
Chọn lộ trình này khi khách hàng đã ủy quyền cho ứng dụng của bạn sử dụng tài khoản ShareAI mà họ đã chọn. Đầu tiên, hoàn tất mã ủy quyền với PKCE và nhận một grant bao gồm surcharge.
https://api.shareai.now/api/v1/chat/completionsThực hiện suy luận theo thỏa thuận ứng dụng mà khách hàng đã chấp nhận.
- URL cơ sở
https://api.shareai.now- Xác thực
- Token truy cập OAuth Bearer
- Phạm vi yêu cầu
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}'
Mã thông báo truy cập được đặt trong tiêu đề Bearer#
Điểm cuối chat và nội dung yêu cầu giống như luồng API-key. Sự khác biệt nằm ở thông tin xác thực và vòng đời ủy quyền của nó. Một refresh token chỉ được gửi đến điểm cuối token; một ID token chỉ được sử dụng để đăng nhập ứng dụng đã xác thực.
Ai trả tiền và gói nào được áp dụng?#
Grant đã được chấp nhận xác định tài khoản cá nhân hoặc tổ chức được chọn, ứng dụng và gói sử dụng. Dịch vụ xác định các giá trị đó từ ủy quyền. Không gửi ID người trả tiền, phí Builder hoặc chủ thể của khách hàng khác trong nội dung chat để thay đổi thanh toán.
Gia hạn quyền truy cập mà không mất sự đồng ý#
Khi access token hết hạn, sử dụng luồng làm mới trên backend của bạn và lưu trữ refresh token thay thế. Khi grant bị thu hồi hoặc cần sự đồng ý mới, kết nối lại khách hàng thông qua luồng trình duyệt.
Xử lý lỗi#
| Kết quả | Hành động |
|---|---|
401 consent_required | Yêu cầu khách hàng kết nối lại nếu ủy quyền không còn hợp lệ. |
403 | Kiểm tra quyền suy luận đã được cấp và quyền truy cập mô hình/nhà cung cấp được phép. |
429 | Tuân thủ Retry-After và giới hạn ứng dụng/tài khoản của bạn. |
503 temporarily_unavailable | Hiển thị lỗi dịch vụ tạm thời; không thông báo cho khách hàng rằng sự đồng ý đã bị thu hồi. |
Cập nhật lần cuối Tháng 9 15, 2026