本文說明如何提供關聯帳單,讓您的客戶將自己的 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 金鑰以及關聯帳單,並按自己的步調遷移客戶。
若要遷移客戶:
繼續使用客戶的 API 金鑰,直到您儲存了他們的連線 ID。
將客戶的請求標記為客戶付款。
刪除儲存的 API 金鑰並告知客戶您已刪除。
設定關聯帳單
若要設定關聯帳單:
在 Claude Console 中建立 OAuth 應用程式。
在應用程式可以執行的操作下,選擇「計費並連結到組織。」
在出現提示時接受關聯帳單條款。
在應用程式的用戶端驗證標籤上,設定用戶端驗證、操作員服務帳戶和預設工作區。
在您的應用程式中新增一個按鈕以開始連結,例如「連結您的 Claude 組織。」使用我們的品牌範例。
為將付款的每個客戶組織建立一個使用者設定檔。每個應用程式允許每個客戶組織一個設定檔,每個設定檔一個客戶組織。
在客戶應該付款的每個請求上,傳送客戶的設定檔 ID、帳單測試版標頭和
billing_policy,其中bill_to設定為user_profile。當您準備好為客戶服務時發佈應用程式。
新應用程式從測試開始。只有您列出的測試使用者(最多 10 個)可以連結它,每個月限制為 $50 或更少。除非您的組織有發票帳單、您驗證了應用程式的網域,並且 Anthropic 在應用程式上線前審查了該應用程式。
連結規則
如果客戶的組織已透過另一個設定檔連結到您的應用程式,連結將被拒絕。
已連結到您的應用程式的設定檔無法連結到第二個組織。
若要移動連結,請先取消連結,然後再次連結。
您無法將應用程式連結到擁有它的 Claude Console 組織。若要像客戶一樣測試關聯帳單,請使用可以連結的第二個 Claude Console 組織。
使用相同的使用者設定檔 ID 來開始連結並進行該客戶的請求。
命名沒有連結的設定檔的客戶付款請求將被拒絕,並出現 403 錯誤,即使客戶的 Console 將您的平台顯示為已連結。
命名您其他客戶設定檔的客戶付款請求將計入該客戶。
若要支付您自己的使用費,請傳送不含 billing_policy 的請求。
如需完整步驟和標頭值,請參閱Claude 平台文件。
客戶連結時看到的內容
當客戶連結其組織時:
他們點擊您新增到應用程式的按鈕,例如「連結您的 Claude 組織。」
他們登入 Claude。如果他們的電子郵件屬於多個組織,他們會選擇一個。如果他們還沒有 Claude 帳戶或 Claude Console 組織,他們可以在此建立,新增點數,然後返回完成連結。
他們閱讀帳單的運作方式,然後為您的應用程式設定每月支出限制或繼續而不設定限制。如果您的應用程式仍在測試中,他們必須設定 $50 或更少的限制。
他們看到一個核准頁面,其中顯示您的應用程式名稱和您要求的內容。它說使用情況根據組織的現有帳單條款計費。
他們核准並返回您的應用程式。
只有具有管理員或帳單角色的使用者才能核准。深入瞭解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 的帳單更正
寫入客戶協議中的點數
無法支付的內容
限制於特定產品的註冊點數
來自 Anthropic 的合作夥伴、風險投資和新創公司計畫的點數(我們仍在推出)
如果客戶帳戶上沒有任何內容可以支付,其請求可能會被拒絕。客戶新增資金後,購買可能需要一些時間才能應用。隨著我們的點數計畫變化,我們可能會更新此清單。
