Отправляйте запросы чата с OAuth

Выберите этот путь, если клиент авторизовал ваше приложение для использования выбранного аккаунта ShareAI. Сначала завершите авторизацию с кодом PKCE и получите грант, который включает 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}'

Токен доступа помещается в заголовок Bearer#

Конечная точка чата и тело запроса такие же, как в потоке с API-ключом. Разница заключается в учетных данных и их жизненном цикле авторизации. Токен обновления отправляется только на конечную точку токенов; ID токен используется только для подтвержденного входа в приложение.

Кто платит и какой план применяется?#

Принятый грант идентифицирует выбранный личный или организационный аккаунт, приложение и план использования. Сервис определяет эти значения из авторизации. Не отправляйте идентификатор плательщика, комиссию Builder или субъект другого клиента в теле чата для изменения биллинга.

Продлите доступ, не теряя согласия#

Когда токен доступа истекает, используйте поток обновления на вашем сервере и сохраните заменяющий токен обновления. Когда грант отзывается или требуется новое согласие, переподключите клиента через браузерный поток.

Обработка ошибок#

Идентификация модели и провайдеры выполнения#

Скопируйте точный идентификатор модели, основанный на создателе, из Модели. Выберите инфраструктуру отдельно с необязательным provider объектом. По умолчанию ранжирование подходящих провайдеров осуществляется по цене, начиная с самой низкой. Выберите провайдеров или ознакомьтесь с полным справочником политики.

Месячные лимиты расходов и восстановление платежей#

Каждый платный аккаунт может установить собственный месячный лимит расходов на ИИ для приложения или клиентского сервиса в разделе Billing → Subscriptions & Commitments. Лимит включает сетевые расходы и наценку разработчика, в то время как фиксированные подписки и подтвержденные покупки остаются отдельными. Ошибка лимита использует HTTP 402 application_spending_limit_exceeded; недостаточно подходящих кредитов использует HTTP 402 insufficient_credits. Оба предоставляют ссылку на выставление счетов клиенту. Пример контракта ошибки, обработки потоков и интеграции.