使用 OAuth 发送聊天请求
使用批准的 ShareAI OAuth 访问令牌进行客户资助的聊天完成,并处理令牌过期、同意和账户边界。
本页面内容
当客户授权您的应用程序使用其选定的 ShareAI 账户时,请选择此路径。首先使用 PKCE 完成授权代码并获取包含以下内容的授权: surcharge.
POST
https://api.shareai.now/api/v1/chat/completions根据客户接受的应用程序协议运行推理。
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer OAuth 访问令牌
- 必需范围
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 密钥流程相同。不同之处在于凭证及其授权生命周期。刷新令牌仅发送到令牌端点;ID 令牌仅用于验证的应用程序登录。
谁支付费用以及适用哪个计划?#
接受的授权标识选定的个人或组织账户、应用程序和使用计划。服务根据授权确定这些值。不要在聊天体中发送付款人 ID、构建者费用或其他客户的主体来更改计费。
在不失去用户授权的情况下续订访问权限#
当访问令牌过期时,请使用 刷新流程 在您的后端存储替换的刷新令牌。当授权被撤销或需要新的用户授权时,通过浏览器流程重新连接客户。
故障处理#
| 结果 | 操作 |
|---|---|
401 consent_required | 如果授权不再有效,请要求客户重新连接。 |
403 | 检查已授予的推理权限以及允许的模型/提供者访问。 |
429 | 遵守 Retry-After 和您的应用程序/账户限制。 |
503 temporarily_unavailable | 显示临时服务错误;不要告诉客户授权已被撤销。 |
模型身份与执行提供者#
从中复制确切的基于创作者的模型标识符 模型。单独选择基础设施,使用可选的 provider 对象。默认情况下按价格排序,最低优先。 选择提供者 或参考 完整的政策参考.
每月支出限额和账单恢复#
每个付费账户可以在 Billing → Subscriptions & Commitments 中为每个应用程序或客户服务设置自己的每月 AI 支出限额。限额包括网络费用和 Builder 附加费,而固定订阅和已确认购买则保持独立。限额错误使用 HTTP 402 application_spending_limit_exceeded; 不足的合格信用使用 HTTP 402 insufficient_credits. 两者均提供客户账单链接。 错误合同、流处理和集成示例.
最后更新日期 2026 年 9 月 18 日