跳至主要內容

在您的平台上提供關聯帳單

本文說明如何提供關聯帳單,讓您的客戶將自己的 Claude Console 組織連結到您的應用程式。我們直接向他們收費,您永遠不會持有他們的 API 金鑰。

關聯帳單處於測試版。

關聯帳單的運作方式

客戶使用 OAuth 將其 Claude Console 組織連結到您的平台,而不是貼上 API 金鑰。您的平台持有連線 ID,而不是金鑰。您為客戶執行 Claude,我們直接向客戶收費。

關聯帳單涵蓋的內容

關聯帳單涵蓋 /v1/messages 和 /v1/chat/completions 端點。您可以選擇每個請求由誰付款:客戶或您。

訊息批次 API 和 Claude 受管代理尚未涵蓋。

客戶付款的請求無法使用可計費的程式碼執行。API 會傳回 400 錯誤,因此請將這些請求作為平台付款傳送。

如果只有某些功能向客戶收費,請告知客戶是哪些功能。除非所有 Claude 使用都計入其組織,否則不要這樣說。

關聯帳單僅適用於 Claude Console 組織由 Anthropic 直接計費的客戶。

以下無法連結:

  • 透過雲端提供者(例如 Bedrock、Vertex AI 或 Foundry)取得 Claude 的客戶無法連結

  • Claude 訂閱計畫(Pro、Max、Ultra、Team 和 Enterprise)無法連結

  • 透過 AWS、Google Cloud 或 Azure Marketplace 付款的 Claude Console 組織無法使用關聯帳單

請求在您的平台組織中執行,而不是在客戶的組織中。只有帳單轉到客戶。客戶組織中的設定(例如 IP 允許清單、加密金鑰和資料保留)不適用,內容根據您的組織與 Anthropic 的協議進行處理。

您所有的關聯客戶共享您的組織的速率限制、模型存取和服務層級。

從 API 金鑰遷移客戶

您可以繼續提供客戶 API 金鑰以及關聯帳單,並按自己的步調遷移客戶。

若要遷移客戶:

  1. 繼續使用客戶的 API 金鑰,直到您儲存了他們的連線 ID。

  2. 將客戶的請求標記為客戶付款。

  3. 刪除儲存的 API 金鑰並告知客戶您已刪除。

設定關聯帳單

若要設定關聯帳單:

  1. 在 Claude Console 中建立 OAuth 應用程式。

  2. 在應用程式可以執行的操作下,選擇「計費並連結到組織。」

  3. 在出現提示時接受關聯帳單條款。

  4. 在應用程式的用戶端驗證標籤上,設定用戶端驗證、操作員服務帳戶和預設工作區。

  5. 在您的應用程式中新增一個按鈕以開始連結,例如「連結您的 Claude 組織。」使用我們的品牌範例。

  6. 為將付款的每個客戶組織建立一個使用者設定檔。每個應用程式允許每個客戶組織一個設定檔,每個設定檔一個客戶組織。

  7. 在客戶應該付款的每個請求上,傳送客戶的設定檔 ID、帳單測試版標頭和 billing_policy,其中 bill_to 設定為 user_profile。

  8. 當您準備好為客戶服務時發佈應用程式。

新應用程式從測試開始。只有您列出的測試使用者(最多 10 個)可以連結它,每個月限制為 $50 或更少。除非您的組織有發票帳單、您驗證了應用程式的網域,並且 Anthropic 在應用程式上線前審查了該應用程式。

連結規則

  • 如果客戶的組織已透過另一個設定檔連結到您的應用程式,連結將被拒絕。

  • 已連結到您的應用程式的設定檔無法連結到第二個組織。

  • 若要移動連結,請先取消連結,然後再次連結。

  • 您無法將應用程式連結到擁有它的 Claude Console 組織。若要像客戶一樣測試關聯帳單,請使用可以連結的第二個 Claude Console 組織。

  • 使用相同的使用者設定檔 ID 來開始連結並進行該客戶的請求。

  • 命名沒有連結的設定檔的客戶付款請求將被拒絕,並出現 403 錯誤,即使客戶的 Console 將您的平台顯示為已連結。

  • 命名您其他客戶設定檔的客戶付款請求將計入該客戶。

若要支付您自己的使用費,請傳送不含 billing_policy 的請求。

如需完整步驟和標頭值,請參閱Claude 平台文件。

客戶連結時看到的內容

當客戶連結其組織時:

  1. 他們點擊您新增到應用程式的按鈕,例如「連結您的 Claude 組織。」

  2. 他們登入 Claude。如果他們的電子郵件屬於多個組織,他們會選擇一個。如果他們還沒有 Claude 帳戶或 Claude Console 組織,他們可以在此建立,新增點數,然後返回完成連結。

  3. 他們閱讀帳單的運作方式,然後為您的應用程式設定每月支出限制或繼續而不設定限制。如果您的應用程式仍在測試中,他們必須設定 $50 或更少的限制。

  4. 他們看到一個核准頁面,其中顯示您的應用程式名稱和您要求的內容。它說使用情況根據組織的現有帳單條款計費。

  5. 他們核准並返回您的應用程式。

只有具有管理員或帳單角色的使用者才能核准。深入瞭解Claude Console 角色和權限。如果其他人嘗試核准,我們會將他們送回您的應用程式,並顯示存取被拒絕錯誤。計劃一次交接,例如將請求傳遞給管理員的方式。

一次核准涵蓋整個組織。連結屬於組織,因此如果核准者離開,它將保持活動。每個組織每個應用程式可以有一個連結。

核准後,客戶的管理員和帳單成員通常會收到一封確認連結的電子郵件,如果他們取消連結,還會收到另一封。

客戶如何管理連結

客戶在 Claude Console 中的連結的平台頁面上管理每個連結。他們可以為您的平台設定每月支出限制並隨時取消連結。從您的應用程式連結到此頁面。

您也可以取消連結客戶。您的組織中的管理員在使用者設定檔頁面上執行此操作。當您在 Console 中取消連結客戶時,客戶不會收到電子郵件,因此請自行告知他們。您也可以從後端取消連結客戶,Anthropic 通常會在您執行此操作時向他們發送電子郵件。

您也可以使用使用者設定檔 API 建立、列出和更新客戶的設定檔。

管理未連結的客戶

當客戶取消連結時,Anthropic 不會向您的應用程式傳送通知。當該客戶的客戶付款請求被拒絕並出現 403 錯誤時,或從 Console 中使用者設定檔頁面上的連結狀態,您會發現。403 也可能意味著客戶因其他原因無法計費。

已連結狀態只表示連結存在。請求仍然可能被拒絕,例如當客戶信用額度不足或達到支出限制時。

取消連結通常在約 10 秒內停止新呼叫。已在執行的呼叫會完成並計入客戶。向客戶顯示清晰的訊息和重新連結的方式。

管理帳單錯誤

如果無法向客戶計費,我們會拒絕該請求。我們不會為該請求向您計費。

  • 如果客戶已達到其支出限制或 Anthropic 目前無法向其計費(例如,因為它信用額度不足或已暫停),您會收到 402 錯誤。

  • 如果 Anthropic 因任何其他原因無法向客戶計費,您會收到 403 錯誤。

  • 如果 Anthropic 目前無法確認客戶是否可以計費,您可能會收到 503 錯誤。使用退避重試,不要向客戶顯示錯誤。

402 表示客戶必須採取行動。要求他們在 Claude Console 中檢查其限制和帳單。

您決定接下來會發生什麼。您可以暫停該功能,直到客戶採取行動,或者您可以透過將請求作為平台付款重新傳送來自行承擔使用費。如果您承擔,請告知客戶時間長度。

監控使用情況和支出

您可以看到每個客戶的使用情況及其成本。您永遠看不到客戶實際支付的金額。

您可以透過兩種方式監控每個客戶的使用情況:

  • 在 Claude Console 中:在使用者設定檔頁面上選擇客戶以查看其使用情況。您的支出只是您代表客戶支付的金額。

  • 使用 API:在使用情況和成本分析 API 中按 user_profile_id 分組結果,該 API 處於測試版。使用情況端點傳回權杖。在成本端點上,amount 是您的成本(扣除點數前),對於客戶付款的請求,它為 0。list_amount 是清單價格的成本,無論誰付款。

兩個檢視都包括客戶的每個請求,無論誰付款。保留您自己的記錄,記錄哪些請求是客戶付款的。API 資料通常在四小時內重新整理,最多可能需要 24 小時。

常見問題

具有 HIPAA、FERPA 或 CMEK 要求的客戶可以連結嗎?

在測試版期間不行。連結的請求在您的組織中執行,因此客戶的業務夥伴協議 (BAA)、加密金鑰和保留設定(包括零資料保留)不適用。不要連結需要 HIPAA、FERPA 或 CMEK 涵蓋的客戶。

哪些點數可以支付連結的使用費?

連結的使用費計入客戶的預付餘額或發票。某些促銷點數無法使用。

可以支付的內容

  • 客戶購買的點數(其預付餘額)

  • 客戶的發票(如果按月計費)

  • 來自 Anthropic 的帳單更正

  • 寫入客戶協議中的點數

無法支付的內容

如果客戶帳戶上沒有任何內容可以支付,其請求可能會被拒絕。客戶新增資金後,購買可能需要一些時間才能應用。隨著我們的點數計畫變化,我們可能會更新此清單。

是否回答了您的問題?