有效管理上游 AI 供應商對於維持可靠且具成本效益的 AI 閘道至關重要。AIGNE Hub 將此流程集中化，提供統一的介面來連接、設定和管理各種 AI 服務的憑證。本節詳細說明處理供應商設定、憑證和模型費率的程序。
下圖說明了供應商、憑證和模型費率在 AIGNE Hub 內的相互關聯：
供應商設定
供應商是將 AIGNE Hub 連接到 OpenAI、Google 和 AWS Bedrock 等上游 AI 服務的基礎元件。正確的設定可確保 Hub 能將請求路由到適當的服務。
新增供應商
要整合新的 AI 服務，您必須將其新增為供應商。每個供應商都需要一個唯一的名稱、一個用於 UI 顯示的名稱，以及特定於服務的詳細資訊，例如 baseUrl 或 region。
請求主體
- name
string(required) — 供應商的官方名稱。必須是支援的供應商值之一（例如 openai、google、bedrock）。 - displayName
string(required) — 供應商的使用者友好名稱，將顯示在 UI 中。 - baseUrl
string— 供應商 API 端點的基礎 URL。大多數供應商都需要此項，但對 AWS Bedrock 而言是選填的。 - region
string— Bedrock 服務的 AWS 區域。僅 bedrock 供應商需要此項。 - enabled
boolean(default:true) — 啟用或停用供應商。已停用的供應商將不會用於路由請求。
更新供應商
您可以修改現有供應商的設定，例如其 baseUrl、region 或 enabled 狀態。
請求主體
- baseUrl
string— 供應商 API 端點的更新後基礎 URL。 - region
string— Bedrock 服務的更新後 AWS 區域。 - enabled
boolean— 供應商的新狀態。
列出與刪除供應商
您可以擷取所有已設定供應商的列表，或根據 ID 刪除特定供應商。刪除供應商也會移除所有相關的憑證和模型費率。
憑證管理
憑證用於向上游 AI 供應商進行身份驗證。AIGNE Hub 會加密並安全地儲存這些憑證，並將其與特定供應商關聯。每個供應商可以有多個憑證，以便進行金鑰輪替和負載平衡。
新增憑證
新增憑證時，您必須指定其類型和值。AIGNE Hub 會自動根據供應商的服務驗證憑證，以確保其有效。
請求主體
- name
string(required) — 憑證的描述性名稱（例如「A 團隊 API 金鑰」）。 - credentialType
string(default:api_key) — 憑證的類型。支援的值為 api_key 和 access_key_pair。 - value
string or object(required) — 憑證值。對於 api_key，這是一個字串。對於 access_key_pair，這是一個包含 access_key_id 和 secret_access_key 的物件。
憑證驗證
AIGNE Hub 包含一個端點，用於檢查已儲存憑證的有效性。此操作會觸發使用指定憑證對供應商進行測試連線，以確認其處於活動狀態並具有必要的權限。
更新與刪除憑證
現有的憑證可以更新為新值或被刪除。當憑證被刪除時，它會從系統中永久移除，並且不能再用於請求。
模型費率管理
模型費率定義了在 AIGNE Hub 中使用特定 AI 模型的成本（以點數計算）。這些費率對於在服務供應商模式下運作的系統至關重要，在該模式下，使用量是根據點數計費的。
新增模型費率
您可以為已設定供應商支援的任何模型定義費率。這包括為輸入和輸出 token（針對文字模型）或每張圖片/影片（針對生成模型）設定不同的點數成本。
請求主體
- model
string(required) — 模型的識別碼（例如 gpt-4o-mini）。 - type
string(required) — 服務的類型。支援的值為 chatCompletion、imageGeneration、embedding 和 video。 - providers
array(required) — 此模型費率適用的供應商 ID 陣列。這允許單一模型由多個供應商提供。 - inputRate
number(required) — 輸入的點數成本（例如，每 1,000 個 token）。 - outputRate
number(required) — 輸出的點數成本（例如，每 1,000 個 token）。 - unitCosts
object— 供應商的實際成本，以美元計，每百萬單位（token/圖片）。用於根據利潤率自動計算費率。- input
number(required) — 每百萬單位的輸入成本。 - output
number(required) — 每百萬單位的輸出成本。
- input
- modelMetadata
object— 關於模型功能的額外元資料。- maxTokens
number— 最大上下文視窗大小。
- maxTokens
批次更新模型費率
為了簡化定價調整，AIGNE Hub 支援根據定義的利潤率和點數價格批次更新模型費率。系統會自動為所有定義了 unitCosts 的模型重新計算 inputRate 和 outputRate。
計算方式如下： 新費率 = (單位成本 * (1 + 利潤率 / 100)) / 點數價格
請求主體
- profitMargin
number(required) — 期望的利潤率百分比（例如，20 代表 20%）。 - creditPrice
number(required) — 單一點數的美元價格。
更新與刪除模型費率
可以修改或移除個別的模型費率。如果刪除模型費率，且已啟用基於點數的計費，則相應模型將不再對使用者可用。
總結
本節涵蓋了在 AIGNE Hub 中管理 AI 供應商、憑證和模型費率的核心功能。正確設定這些資源對於您的 AI 服務的安全性、可靠性和財務管理至關重要。
有關相關主題的更多資訊，請參考以下部分：
服務供應商模式
了解如何設定基於點數的計費和自訂定價模型。
安全與存取控制
了解安全架構，包括加密儲存和存取控制。