Gửi yêu cầu hội thoại với OAuth

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.

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#

Danh tính mô hình và nhà cung cấp thực thi#

Sao chép chính xác mã định danh mô hình dựa trên người tạo từ Mô hình. Chọn cơ sở hạ tầng riêng biệt với tùy chọn provider đối tượng. Mặc định xếp hạng các nhà cung cấp đủ điều kiện theo giá, từ thấp đến cao. Chọn nhà cung cấp hoặc tham khảo tài liệu chính sách đầy đủ.

Giới hạn chi tiêu hàng tháng và khôi phục thanh toán#

Mỗi tài khoản trả phí có thể đặt giới hạn chi tiêu AI hàng tháng riêng cho từng ứng dụng hoặc dịch vụ khách hàng trong Thanh toán → Đăng ký & Cam kết. Giới hạn bao gồm chi phí mạng và phụ phí của Builder, trong khi các đăng ký cố định và giao dịch mua đã xác nhận được tách riêng. Lỗi vượt giới hạn sử dụng HTTP 402 application_spending_limit_exceeded; tín dụng đủ điều kiện không đủ sử dụng HTTP 402 insufficient_credits. Cả hai đều cung cấp liên kết thanh toán cho khách hàng. Hợp đồng lỗi, xử lý luồng và ví dụ tích hợp.