К основному содержимому

Предложите связанное выставление счетов на вашей платформе

В этой статье объясняется, как предложить связанное выставление счетов, которое позволяет вашим клиентам связать свою организацию Claude Console с вашим приложением. Мы выставляем им счета напрямую, и вы никогда не храните их ключ API.

Связанное выставление счетов находится на этапе бета-тестирования.

Как работает связанное выставление счетов

Клиент связывает свою организацию Claude Console с вашей платформой через OAuth вместо вставки ключа API. Ваша платформа хранит ID подключения, а не ключ. Вы запускаете Claude для клиента, и мы выставляем счет клиенту напрямую.

Что охватывает связанное выставление счетов

Связанное выставление счетов охватывает конечные точки /v1/messages и /v1/chat/completions. Вы выбираете, кто платит за каждый запрос: клиент или вы.

API Message Batches и Claude Managed Agents пока не охватываются.

Запросы, оплачиваемые клиентом, не могут использовать оплачиваемое выполнение кода. API возвращает ошибку 400, поэтому отправляйте эти запросы как оплачиваемые платформой.

Если только некоторые функции выставляют счета клиенту, сообщите клиентам, какие именно. Не говорите, что все использование Claude выставляется их организации, если это не так.

Связанное выставление счетов работает только для клиентов, организация Claude Console которых выставляется напрямую Anthropic.

Следующее не может быть связано:

  • Клиенты, получающие Claude через поставщика облачных услуг, такого как Bedrock, Vertex AI или Foundry, не могут связать

  • Планы подписки Claude (Pro, Max, Ultra, Team и Enterprise) не могут быть связаны

  • Организации Claude Console, которые платят через AWS, Google Cloud или Azure Marketplace, не могут использовать связанное выставление счетов

Запросы выполняются в организации вашей платформы, а не клиента. Только выставление счетов переходит клиенту. Параметры в организации клиента, такие как списки разрешенных IP-адресов, ключи шифрования и хранение данных, не применяются, и содержимое обрабатывается в соответствии с соглашением вашей организации с Anthropic.

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

Перемещение клиентов с ключей API

Вы можете продолжать предлагать ключи API клиентов наряду со связанным выставлением счетов и переводить клиентов в своем темпе.

Чтобы переместить клиента:

  1. Продолжайте использовать ключ API клиента, пока не сохраните его ID подключения.

  2. Отметьте запросы клиента как оплачиваемые клиентом.

  3. Удалите сохраненный ключ API и сообщите клиенту об этом.

Настройка связанного выставления счетов

Чтобы настроить связанное выставление счетов:

  1. Создайте приложение OAuth в Claude Console.

  2. В разделе Что может делать приложение выберите «Выставлять счета и связывать с организациями.»

  3. Примите Условия связанного выставления счетов при появлении запроса.

  4. На вкладке Аутентификация клиента приложения настройте аутентификацию клиента, учетную запись оператора и рабочее пространство по умолчанию.

  5. Добавьте кнопку в ваше приложение, которая начинает связывание, например «Свяжите вашу организацию Claude.» Используйте наши образцы брендирования.

  6. Создайте один профиль пользователя для каждой организации клиента, которая будет платить. Каждое приложение позволяет один профиль на организацию клиента и одну организацию клиента на профиль.

  7. Для каждого запроса, за который должен платить клиент, отправьте ID профиля клиента, заголовок бета-версии выставления счетов и billing_policy с bill_to, установленным на user_profile.

  8. Опубликуйте приложение, когда будете готовы для клиентов.

Новое приложение начинается с тестирования. Только указанные вами тестовые пользователи (до 10) могут связать его, каждый с ежемесячным лимитом $50 или меньше. Если ваша организация не имеет выставления счетов по счету, вы проверяете домен приложения, и Anthropic проверяет приложение перед его запуском.

Правила связывания

  • Если организация клиента уже связана с вашим приложением через другой профиль, связь отклоняется.

  • Профиль, который уже связан с вашим приложением, не может быть связан со второй организацией.

  • Чтобы переместить связь, сначала отсоедините ее, а затем снова свяжите.

  • Вы не можете связать ваше приложение с организацией Claude Console, которая его владеет. Чтобы протестировать связанное выставление счетов как клиент, используйте вторую организацию Claude Console, которая может связать.

  • Используйте один и тот же ID профиля пользователя для начала связи и для запросов этого клиента.

  • Запрос, оплачиваемый клиентом, который указывает профиль без связи, отклоняется с ошибкой 403, даже если консоль клиента показывает вашу платформу как Связанную.

  • Запрос, оплачиваемый клиентом, который указывает профили других ваших клиентов, выставляется этому клиенту.

Чтобы платить за собственное использование, отправляйте запросы без billing_policy.

Для полных шагов и значений заголовков см. Документацию платформы Claude.

Что видят клиенты при связывании

Когда клиенты связывают свою организацию:

  1. Они нажимают кнопку, которую вы добавили в ваше приложение, например «Свяжите вашу организацию Claude.»

  2. Они входят в Claude. Если их электронная почта принадлежит более чем одной организации, они выбирают одну. Если у них еще нет учетной записи Claude или организации Claude Console, они могут создать их здесь, добавить кредиты и затем вернуться, чтобы завершить связывание.

  3. Они читают, как работает выставление счетов, а затем устанавливают ежемесячный лимит расходов для вашего приложения или продолжают без него. Если ваше приложение все еще находится на этапе тестирования, они должны установить лимит $50 или меньше.

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

  5. Они одобряют и возвращаются в ваше приложение.

Только пользователь с ролью Admin или Billing может одобрить. Узнайте больше о ролях и разрешениях Claude Console. Если кто-то другой попытается одобрить, мы отправим его обратно в ваше приложение с ошибкой отказа в доступе. Спланируйте передачу, например способ передачи запроса администратору.

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

После одобрения члены Admin и Billing организации клиента обычно получают электронное письмо, подтверждающее связь, и еще одно, если они отсоединяют.

Как клиенты управляют связью

Клиенты управляют каждой связью на странице Связанные платформы в Claude Console. Они могут установить ежемесячный лимит расходов для вашей платформы и отсоединить в любое время. Свяжите эту страницу из вашего приложения.

Вы также можете отсоединить клиента. Администратор в вашей организации делает это на странице Профили пользователей. Клиент не получает электронное письмо, когда вы отсоединяете его в консоли, поэтому сообщите ему сами. Вы также можете отсоединить клиента из вашего бэкенда, и Anthropic обычно отправляет ему электронное письмо, когда вы это делаете.

Вы также можете создавать, перечислять и обновлять профили ваших клиентов с помощью API профилей пользователей.

Управление несвязанными клиентами

Anthropic не отправляет вашему приложению уведомление, когда клиент отсоединяется. Вы узнаете об этом, когда запрос, оплачиваемый клиентом, для этого клиента отклоняется с ошибкой 403, или из Статуса связи на странице Профили пользователей в консоли. Ошибка 403 также может означать, что клиент не может быть выставлен по счету по другой причине.

Статус Связано только говорит, что связь существует. Запрос все еще может быть отклонен, например, когда клиент исчерпал кредиты или достиг лимита расходов.

Отсоединение обычно останавливает новые вызовы в течение примерно 10 секунд. Уже выполняемые вызовы завершаются и выставляются клиенту. Покажите клиенту четкое сообщение и способ снова связать.

Управление ошибками выставления счетов

Если клиент не может быть выставлен по счету, мы отклоняем запрос. Мы не выставляем вам счет за этот запрос.

  • Если клиент достиг лимита расходов или Anthropic в настоящее время не может выставить ему счет (например, потому что он исчерпал кредиты или приостановлен), вы получаете ошибку 402.

  • Если Anthropic не может выставить клиенту счет по какой-либо другой причине, вы получаете ошибку 403.

  • Если Anthropic в настоящее время не может подтвердить, может ли клиент быть выставлен по счету, вы можете получить ошибку 503. Повторите попытку с отступом и не показывайте клиенту ошибку.

Ошибка 402 означает, что клиент должен действовать. Попросите его проверить свои лимиты и выставление счетов в Claude Console.

Вы решаете, что происходит дальше. Вы можете приостановить функцию до тех пор, пока клиент не действует, или вы можете покрыть использование сами, отправив запрос как оплачиваемый платформой. Если вы покрываете это, сообщите клиенту, как долго.

Мониторинг использования и расходов

Вы видите использование каждого клиента и его стоимость для вас. Вы никогда не видите, что клиент фактически платит.

Вы можете отслеживать использование каждого клиента двумя способами:

  • В Claude Console: Выберите клиента на странице Профили пользователей, чтобы увидеть его использование. Ваши расходы — это только то, что вы заплатили от имени клиента.

  • С помощью API: Сгруппируйте результаты по user_profile_id в API аналитики использования и затрат, который находится на этапе бета-тестирования. Конечная точка использования возвращает токены. На конечной точке затрат amount — это ваша стоимость до кредитов, и она равна 0 для запросов, которые платит ваш клиент. list_amount — это стоимость по прейскуранту, независимо от того, кто платит.

Оба представления включают каждый запрос для клиента, независимо от того, кто платил. Ведите собственный учет того, какие запросы были оплачены клиентом. Данные API обычно обновляются в течение четырех часов и могут занять до 24 часов.

Часто задаваемые вопросы

Могут ли клиенты с требованиями HIPAA, FERPA или CMEK связать?

Не во время бета-версии. Связанные запросы выполняются в вашей организации, поэтому соглашение о деловом партнере клиента (BAA), ключи шифрования и параметры хранения, включая нулевое хранение данных, не применяются. Не связывайте клиентов, которым требуется покрытие HIPAA, FERPA или CMEK.

Какие кредиты могут оплачивать связанное использование?

Связанное использование выставляется на предоплаченный баланс клиента или счет. Некоторые рекламные кредиты не могут быть использованы.

Что может платить

  • Кредит, который купил клиент (его предоплаченный баланс)

  • Счет клиента, если он выставляется ежемесячно

  • Исправления выставления счетов от Anthropic

  • Кредиты, записанные в соглашение клиента

Что не может платить

Если на счете клиента нечем платить, его запросы могут быть отклонены. После того как клиент добавит средства, покупка может занять некоторое время. Мы можем обновить этот список по мере изменения наших программ кредитов.

Нашли ответ на свой вопрос?