Skip to main content
DGrid API 參考文件分為三大 API 介面，每個介面都有各自的驗證方式與用途：

模型 API

相容 OpenAI、Claude 與 Gemini 的端點，支援聊天、文字補全、嵌入向量、圖像、音訊與內容審核。

管理 API 金鑰

以程式化方式管理模型 API 金鑰的完整生命週期——建立、輪換、限制、停用與撤銷。

x402 API

使用 x402 支付協定，按次推論付費，無需預先儲值的帳戶餘額。
每個模型 API 參考頁面都附有互動式試用工具：填入您的 API 金鑰與參數，然後按下「Send」，即可對 https://api.dgrid.ai 進行即時端點測試。

​
模型 API

模型 API 為您提供一個統一的閘道，可存取 200 多個領先的 AI 模型。每個端點皆相容於一種生態系統標準——OpenAI、Claude 或 Gemini——因此您現有的 SDK 與工具皆可不做修改直接使用。 若需要進行請求級成本對帳，請保存 DGrid-Request-ID 回應標頭，並使用取得請求計費明細查詢 token 用量、定價與美元成本。

​
基礎網址

​
身分驗證

所有模型 API 端點皆透過 Bearer Token 進行驗證：
相容 Claude 的 POST /v1/messages 端點還需要額外提供：
請依照金鑰建立指南取得您的金鑰，或使用管理 API 金鑰介面以程式化方式管理金鑰生命週期。

​
模型命名

model 參數使用 provider/model-name 格式——例如 openai/gpt-4o——此格式在所有 DGrid 支援的模型中皆一致。呼叫列出模型以查詢您的金鑰可使用的模型 ID。

​
端點分類

​
最佳實務

  1. 將 DGrid API 金鑰儲存於伺服器端，切勿將其暴露於公開的客戶端或程式碼庫中。
  2. 若希望取得最廣泛的 SDK 相容性並降低遷移成本，建議優先使用相容 OpenAI 的格式。
  3. 僅在需要特定供應商的負載特性（例如 Gemini 多模態內容部分或 Claude 工具負載）時，才使用供應商原生格式。
  4. 確保請求與回應範例與您所使用的目標模型系列保持一致，因為 OpenAI、Claude 與 Gemini 風格之間的參數名稱有所不同。

​
管理 API 金鑰

管理 API 金鑰是用於管理模型 API 金鑰完整生命週期的管理憑證——包括建立、輪換、使用限制、停用與撤銷。這類金鑰僅限於金鑰管理操作，無法呼叫模型 API 的推論端點。 請參閱管理 API 金鑰，了解 API 介面、驗證邊界與端點參考文件。

​
x402 API

x402 API 是 DGrid 的按次推論付費存取模式。無需建立帳戶或預先儲值，每次請求皆透過 x402 支付協定逐次授權並結算——非常適合自主代理與隨需整合的場景。 請參閱 x402 API 了解付款流程，以及 x402 API 參考文件了解端點詳情。