> For the complete documentation index, see [llms.txt](https://docs.apismart.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/apismart-jian-jie.md).

# ApiSmart 簡介

[ApiSmart](https://www.apismart.ai/) 是一個 **統一的 AI API 平台** 專為建構 AI 驅動應用程式的開發者與企業所設計。

與其為不同的 AI 模型供應商維護各自獨立的整合，ApiSmart 提供了一個集中式方式來存取受支援的 **文字、圖片與影片模型**，管理 API 憑證、監控用量，並將 AI 功能整合到您的應用程式中。

### 🧩 什麼是 ApiSmart？

現代 AI 應用程式通常依賴多個模型與模型供應商。

單一應用程式可能使用一個模型來進行對話或推理，另一個模型用於圖片生成，還有一個影片模型處理多媒體工作流程。若要分別管理每個供應商，可能意味著需要處理不同的憑證、API 格式、計費系統與營運需求。

ApiSmart 透過提供統一的 API 閘道，以及在受支援的 AI 服務之間一致的開發者體驗，簡化了這個流程。

使用 ApiSmart，您可以：

* 從單一平台存取多個 AI 模型家族
* 使用文字、圖片與影片生成 API
* 對受支援的文字模型使用熟悉的 Chat Completions API 格式
* 只需極少的整合變更即可在受支援模型之間切換
* 從集中式 Console 管理 API 金鑰
* 監控 API 用量與請求活動
* 透過單一帳戶管理用量與計費

### ⚡ 為什麼使用 ApiSmart？

#### 統一的模型存取

ApiSmart 提供一個單一平台，讓您可存取來自不同模型家族的受支援模型。

與其維護多個獨立的供應商整合，您的應用程式可以使用 ApiSmart 閘道，並透過其 `模型` ID 選取所需模型。

#### 熟悉的 API 整合

文字模型使用與 OpenAI 相容的 Chat Completions 介面：

`POST /v1/chat/completions`

對於已經以 Chat Completions 風格 API 建立的應用程式，整合通常只需要更新 API 端點、API 金鑰與模型 ID，而不是重新設計應用程式架構。

圖片與影片模型則使用專為各自生成工作流程設計的專用端點。

#### 彈性的模型選擇

每個請求都會透過 `模型` 參數指定您要使用的模型。

例如：

```json
{
  "model": "deepseek-v4-flash"
}
```

您可以以程式方式取得最新可用的模型 ID：

```bash
curl https://gw.apismart.ai/v1/models \\
  -H "Authorization: Bearer <your-api-key>"
```

將回傳的 `data[].id` 值作為 `模型` 受支援 API 請求中的參數。

> **重要：** 模型 ID 必須完全一致。請留意句點（`.`）、連字號（`-`）以及版本號。

#### 可靠性與可觀測性

ApiSmart 的設計目標是在您的應用程式與受支援的 AI 模型服務之間提供一層集中式基礎架構。

平台能力包括智慧路由、自動故障轉移、請求監控、用量分析與集中式成本追蹤。

這些功能有助於減少管理多個獨立 AI 服務整合時所需的營運工作。

### ✨ 支援的 AI 工作負載

ApiSmart 透過專用 API 支援多種類型的 AI 工作負載。

#### 文字生成

文字模型使用 Chat Completions API：

`POST /v1/chat/completions`

常見應用包括：

* AI 助理
* 對話式介面
* 內容生成
* 摘要
* 推理
* 程式撰寫輔助
* 其他以文字為基礎的 AI 工作流程

文字回應可正常返回，或在支援時以串流方式傳回。

#### [圖片生成](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md)

圖片生成使用：

`POST /v1/images/generations`

支援的工作流程可包含：

* 文字轉圖片生成
* 圖片轉圖片生成
* 多張參考圖片
* 連續圖片生成
* 圖片編輯
* 串流圖片輸出

本地圖片上傳也可以透過以下方式處理：

`POST /v1/images/edits`

#### [影片生成](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)

影片生成使用非同步任務：

`POST /v1/video/tasks`

根據所選模型，支援的工作流程可包含：

* 文字轉影片
* 圖片轉影片
* 基於參考的影片生成
* 影片編輯
* 首幀與末幀生成
* 使用圖片、影片與音訊的多模態工作流程

由於影片生成是非同步的，API 會回傳一個任務 ID，您可用它來檢查生成狀態。

### 🔑 API 存取

標準的 ApiSmart API 基礎網址是：

`https://gw.apismart.ai/v1`

API 請求使用 API 金鑰進行驗證：

```http
Authorization: Bearer <your-api-key>
```

您可以從以下位置建立與管理 API 金鑰：

**Console → API Keys**

請妥善保管您的 API 金鑰，切勿將其公開在公開儲存庫、瀏覽器端程式碼或其他可公開存取的位置。

### 🔄 ApiSmart 的運作方式

典型的 ApiSmart 整合流程包含四個步驟：

1. **建立 API 金鑰**\
   從 ApiSmart Console 為您的應用程式建立憑證。
2. **選擇模型**\
   選取受支援的模型，或使用 `GET /v1/models` 來取得目前的模型 ID。
3. **傳送 API 請求**\
   使用適當的 Chat Completions、圖片生成或影片生成端點。
4. **監控用量**\
   從 Console 檢視 API 活動、用量以及相關成本。

這個架構讓您能在同一平台內處理不同的 AI 能力，同時維持驗證、模型存取、用量監控與帳戶管理。

### 👨‍💻 ApiSmart 適合誰？

ApiSmart 是為了希望以更簡單方式整合與管理 AI 模型 API 的開發者與團隊所設計。

它適用於：

* 建構 AI 驅動應用程式的開發者
* 評估多個 AI 模型的團隊
* 整合生成式 AI 功能的 SaaS 產品
* 後端與平台工程團隊
* 管理多個 AI 工作負載的企業
* 結合文字、圖片與影片生成的應用程式

無論您是在首次測試模型，還是將 AI 功能整合到正式上線的應用程式中，ApiSmart 都能提供一致的基礎來存取受支援的 AI 服務。

### 🚀 下一步

如果您是 ApiSmart 新手，請從以下內容開始：

* [**快速開始**](/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-ru-men.md) — 進行您的第一次 API 請求
* [**API 金鑰**](/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue.md) — 了解驗證如何運作
* [**模型與模型 ID**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-yu-mo-xing-id.md) — 尋找並選取受支援的模型
* [**模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md) — 了解不同模型如何計費
* [**API 基礎**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md) — 了解 ApiSmart API 共通使用規則

當您準備開始建置時，請探索：

* [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-wan-cheng-api.md)
* [**圖片生成 API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md)
* [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)