> 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.md).

# 歡迎使用 ApiSmart

使用 AI 模型打造 **文字、圖片與影片** 透過一個統一的 API 平台。

ApiSmart 讓開發者能以一致的方式存取受支援的 AI 模型、管理 API 憑證、監控使用情況，並將 AI 功能整合到應用程式中。

{% hint style="info" %}
**ApiSmart API**

基礎 URL： `https://gw.apismart.ai/v1`

驗證： `Authorization: Bearer <your-api-key>`
{% endhint %}

***

### 🚀 從這裡開始

初次使用 ApiSmart？先從這三個指南開始。

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>ApiSmart 簡介</h4><p>了解 ApiSmart 是什麼、平台如何運作，以及你可以用它打造什麼。</p></td><td><a href="/pages/299a0af1604e9fe5a928e3963dc54e1e80fcdf23">/pages/299a0af1604e9fe5a928e3963dc54e1e80fcdf23</a></td></tr><tr><td><h4>快速入門</h4><p>建立 API 金鑰、找出可用模型，並送出你的第一個 API 請求。   </p></td><td><a href="/pages/fd807132ea67bae81d289eadc065352faf2e83bf">/pages/fd807132ea67bae81d289eadc065352faf2e83bf</a></td></tr><tr><td><h4>API 金鑰</h4><p>了解 API 驗證的運作方式，以及如何建立、管理並保護你的 API 金鑰。</p></td><td><a href="/pages/805c7c6562faffddac3d1d4f4110b4a6caa1c8f0">/pages/805c7c6562faffddac3d1d4f4110b4a6caa1c8f0</a></td></tr></tbody></table>

***

### ⚡ 使用 ApiSmart 打造

選擇與你想打造的內容相符的 API。

【GitBook 操作：插入 `卡片`，建議使用 3 張中型卡片，一行 3 張。每張卡片可使用 GitBook 內建小圖示】

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>💬 聊天補全 API</h4><p>建構對話式 AI、內容生成、推理及其他以文字為基礎的應用程式。</p><p><code>POST /v1/chat/completions</code></p></td><td><a href="/pages/57a2c0e072a48b52398d53d9a22fa8728729ef2b">/pages/57a2c0e072a48b52398d53d9a22fa8728729ef2b</a></td></tr><tr><td><h4>🖼️ 圖片生成 API</h4><p>使用文字提示、參考圖片及支援的圖片編輯工作流程來生成與轉換圖片。</p><p><code>POST /v1/images/generations</code></p></td><td><a href="/pages/32188b290a0007041e6712346f8c26f6ac1072f3">/pages/32188b290a0007041e6712346f8c26f6ac1072f3</a></td></tr><tr><td><h4>🎬 影片生成 API</h4><p>使用文字、圖片、影片、音訊及支援的多模態參考來建立影片。</p><p><code>POST /v1/video/tasks</code></p></td><td><a href="/pages/665cfd3b87ac5bd33c77276697960420d940dcea">/pages/665cfd3b87ac5bd33c77276697960420d940dcea</a></td></tr></tbody></table>

***

### 🧩 找到合適的模型

每個 API 請求都會使用 `模型` ID 來指定你要呼叫的模型。

若要擷取最新模型清單：

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

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

**模型 ID 必須完全相符。**

注意句點（`.`）、連字號（`-`）、以及版本號碼，在複製模型 ID 時。

若要查看模型可用性、模型 ID 與定價資訊，請參閱 [**模型與模型 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).

***

### 📚 探索文件

尋找模型、使用方式、SDK 與疑難排解指南。

【GitBook 操作：插入 4 張卡片。建議使用大型卡片，一行 2 張，共兩行】

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>模型與定價</h4><p>探索可用模型、模型 ID、定價與計費方式。</p></td><td><a href="/pages/3662df206a2a79336889335059cb554f8199966f">/pages/3662df206a2a79336889335059cb554f8199966f</a></td><td><a href="/pages/fc7be2651c6e2bf7bd020be6f54a655775aa927f">/pages/fc7be2651c6e2bf7bd020be6f54a655775aa927f</a></td></tr><tr><td><h4>API 使用情況</h4><p>檢視 API 活動、請求使用情況與相關成本。</p><p><strong>連結到：</strong> 使用記錄與成本</p></td><td><a href="/pages/5e3e76435be7d61ae530ff12a9a070e03cb2457e">/pages/5e3e76435be7d61ae530ff12a9a070e03cb2457e</a></td><td></td></tr><tr><td><h4>SDK 與遷移</h4><p>尋找適合你偏好開發環境的實作整合範例。</p><p><strong>可用指南：</strong></p><ul><li>cURL</li><li>Python</li><li>JavaScript 與 TypeScript</li></ul></td><td></td><td><a href="/pages/64983861b6de3e71b35904e1fdc22aaa29ba9dc5">/pages/64983861b6de3e71b35904e1fdc22aaa29ba9dc5</a></td></tr><tr><td><h4>疑難排解</h4><p>尋找常見 API 整合與使用問題的解決方案。</p><p><strong>主題包括：</strong></p><ul><li>HTTP 狀態碼與 API 錯誤</li><li>API 金鑰與驗證問題</li><li>模型與請求錯誤</li><li>餘額與使用限制</li><li>逾時與連線問題</li></ul></td><td></td><td></td></tr></tbody></table>

***

### 🔄 了解回應模式

不同的 ApiSmart API 使用不同的回應模式。

| API  | 回應模式  |
| ---- | ----- |
| 聊天補全 | 標準或串流 |
| 圖片生成 | 同步或串流 |
| 影片生成 | 非同步任務 |

如需實作細節，請參閱 **回應模式**:

* 標準回應
* 串流文字回應
* 串流圖片回應
* 非同步影片任務

***

### ✅ 準備好開始打造了嗎？

開始之前，你不需要先讀完全部文件。

{% hint style="success" %}
**發出你的第一個 API 請求**

繼續前往 [**快速入門**](/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-ru-men.md) 以建立 API 金鑰、選擇模型並送出你的第一個請求。
{% endhint %}