ShareAI Platform Docs

使用 OAuth 发送聊天请求

使用批准的 ShareAI OAuth 访问令牌进行客户资助的聊天完成,并处理令牌过期、同意和账户边界。

查看为Markdown格式
本页面内容

当客户授权您的应用程序使用其选定的 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 日

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

选择一个助手来探索此页面。您也可以复制页面并将其粘贴到您的对话中。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI