使用 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 | 显示临时服务错误;不要告诉客户授权已被撤销。 |
最近更新于 9 月 15, 2026