> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dgrid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 簡介

> DGrid 三大 API 介面總覽：用於模型推論的 Model API、管理金鑰的 Management API Keys，以及按次推論付費的 x402 API，完整說明驗證方式、基礎 URL、相容性、應用場景與請求流程，協助開發者快速選對適合產品需求的 API 介面。

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

<CardGroup cols={3}>
  <Card title="模型 API" icon="brain" href="#model-api">
    相容 OpenAI、Claude 與 Gemini 的端點，支援聊天、文字補全、嵌入向量、圖像、音訊與內容審核。
  </Card>

  <Card title="管理 API 金鑰" icon="key" href="/zh-Hant/management-api-keys">
    以程式化方式管理模型 API 金鑰的完整生命週期——建立、輪換、限制、停用與撤銷。
  </Card>

  <Card title="x402 API" icon="credit-card" href="/zh-Hant/x402/overview">
    使用 x402 支付協定，按次推論付費，無需預先儲值的帳戶餘額。
  </Card>
</CardGroup>

<Note>
  每個模型 API 參考頁面都附有互動式試用工具：填入您的 API 金鑰與參數，然後按下<strong>「Send」</strong>，即可對 `https://api.dgrid.ai` 進行即時端點測試。
</Note>

<span id="model-api" />

## 模型 API

模型 API 為您提供一個統一的閘道，可存取 200 多個領先的 AI 模型。每個端點皆相容於一種生態系統標準——OpenAI、Claude 或 Gemini——因此您現有的 SDK 與工具皆可不做修改直接使用。

若需要進行請求級成本對帳，請保存 `DGrid-Request-ID` 回應標頭，並使用[取得請求計費明細](/zh-Hant/api-reference/usage-and-billing/get-request-billing-details)查詢 token 用量、定價與美元成本。

### 基礎網址

```text theme={null}
https://api.dgrid.ai
```

### 身分驗證

所有模型 API 端點皆透過 Bearer Token 進行驗證：

```http theme={null}
Authorization: Bearer <DGRID_API_KEY>
```

相容 Claude 的 `POST /v1/messages` 端點還需要額外提供：

```http theme={null}
anthropic-version: 2023-06-01
```

請依照[金鑰建立指南](https://blog.dgrid.ai/posts/2026-01-04/)取得您的金鑰，或使用[管理 API 金鑰](/zh-Hant/management-api-keys)介面以程式化方式管理金鑰生命週期。

### 模型命名

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

### 端點分類

| 分類    | 基礎路徑                                                                                       | 最適合用於                    |
| ----- | ------------------------------------------------------------------------------------------ | ------------------------ |
| 聊天    | `/v1/chat/completions`、`/v1/responses`、`/v1/messages`、`/v1/models/{model}:generateContent` | 對話應用程式、多模態助理、工具呼叫        |
| 文字補全  | `/v1/completions`                                                                          | 純提示詞文字生成與舊版整合            |
| 嵌入向量  | `/v1/embeddings`、`/v1/engines/{engine}/embeddings`                                         | 搜尋、聚類、檢索、排序              |
| 圖像    | `/v1/images/generations`、`/v1/images/edits`                                                | 跨模型格式的圖像生成與編輯            |
| 音訊    | `/v1/audio/speech`、`/v1/audio/transcriptions`、`/v1/audio/translations`                     | 語音合成、轉錄、翻譯               |
| 內容審核  | `/v1/moderations`                                                                          | 內容安全篩選與政策檢查              |
| 模型    | `/v1/models`                                                                               | 查詢可用模型與支援的端點類型           |
| 用量與計費 | `/api/v1/model-router/billing-json`                                                        | 查詢請求級 token 用量、定價快照與美元成本 |
| 即時對話  | `/v1/realtime`（WebSocket）                                                                  | 低延遲串流對話                  |

### 最佳實務

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

## 管理 API 金鑰

管理 API 金鑰是用於管理模型 API 金鑰完整生命週期的管理憑證——包括建立、輪換、使用限制、停用與撤銷。這類金鑰僅限於金鑰管理操作，無法呼叫模型 API 的推論端點。

請參閱[管理 API 金鑰](/zh-Hant/management-api-keys)，了解 API 介面、驗證邊界與端點參考文件。

## x402 API

x402 API 是 DGrid 的按次推論付費存取模式。無需建立帳戶或預先儲值，每次請求皆透過 x402 支付協定逐次授權並結算——非常適合自主代理與隨需整合的場景。

請參閱 [x402 API](/zh-Hant/x402/overview) 了解付款流程，以及 [x402 API 參考文件](/zh-Hant/x402/api-reference)了解端點詳情。