> 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/kuai-su-kai-shi.md).

# 快速開始

在幾分鐘內開始使用 ApiSmart。建立 API 金鑰、找到可用模型，並送出您的第一個文字、圖片或影片 API 請求。

只需幾個步驟即可開始使用 ApiSmart。

本指南將示範如何建立 API 金鑰、尋找可用模型，以及送出您的第一個 API 請求。

### 🚀 開始之前

請確認您已具備：

* ApiSmart 帳戶
* 足夠的錢包餘額，以使用您想要的模型
* API 金鑰

如果您尚未建立帳戶或加值，請參閱 [**建立並存取您的帳戶**](/documentation/zh-tw/zhang-hu-yu-qian-bao/jian-li-bing-cun-qu-nin-de-zhang-hu.md) 以及 [**加值並了解錢包點數**](/documentation/zh-tw/zhang-hu-yu-qian-bao/jia-zhi-yu-liao-jie-qian-baoedu.md).

***

### 🔑 步驟 1：建立 API 金鑰

登入 ApiSmart Console，並前往：

**Console → API Keys**

點選 **Create API Key** 並為您的應用程式建立憑證。

您的 API 金鑰用於驗證 API 請求。

在本文件中，我們使用：

`<your-api-key>`

在送出請求時，請將此預留位置替換為您的實際 API 金鑰。

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

如需金鑰管理與安全最佳實務，請參閱 [**API Keys**](/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue.md).

***

### 🔗 步驟 2：設定 API

標準的 ApiSmart API Base URL 為：

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

使用 `Authorization` 標頭來驗證請求：

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

對於 JSON 請求，另請包含：

```http
Content-Type: application/json
```

***

### 🧩 步驟 3：尋找模型

在送出請求之前，您可以先取得目前的模型清單：

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

範例回應：

```json
{
  "object": "list",
  "data": [
    {
      "id": "doubao-seedream-5-0",
      "object": "model",
      "owned_by": "api-gateway"
    },
    {
      "id": "deepseek-v4-flash",
      "object": "model",
      "owned_by": "api-gateway"
    }
  ]
}
```

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

> **模型 ID 必須完全一致。**\
> 請注意句點（`.`）、連字號（`-`）與版本號。

Models API 可能會回傳某些未對每個 API 金鑰啟用的模型。如果請求回傳 `403 model_not_allowed`，表示所選模型目前無法供您的 API 金鑰使用。

如需更多資訊，請參閱 [**模型與模型 ID**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md).

***

### 💬 步驟 4：送出您的第一個請求

測試整合最快的方法是使用 Chat Completions API。

將請求送至：

`POST /v1/chat/completions`

```bash
curl https://gw.apismart.ai/v1/chat/completions \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "user",
        "content": "Hello! Please introduce yourself."
      }
    ]
  }'
```

如果請求成功，API 會傳回由所選模型生成的回應。

您現在已完成第一個 ApiSmart API 請求。

***

### 🖼️ 選用：試試影像生成

若要生成影像，請使用：

`POST /v1/images/generations`

範例：

```bash
curl https://gw.apismart.ai/v1/images/generations \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "A mountain village at sunrise, watercolor style",
    "size": "2K",
    "watermark": false
  }'
```

影像生成是同步的，因此連線會保持開啟直到生成完成。

對於較長時間執行的請求，請將用戶端逾時設定至少為 **90 秒**.

如需支援的參數、參考影像、影像編輯與串流，請參閱 [**影像生成 API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md).

***

### 🎬 選用：試試影片生成

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

使用下列方式建立任務：

`POST /v1/video/tasks`

```bash
curl https://gw.apismart.ai/v1/video/tasks \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0",
    "prompt": "A miniature city at night with a train moving through the streets",
    "duration": 5,
    "size": "720P"
  }'
```

API 會回傳一個任務 ID。

請使用它來檢查任務狀態：

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

持續檢查直到任務達到最終狀態，例如 `成功` 或 `失敗`.

> 對於影片請求，請明確指定例如 `解析度` 以及 `時長` 等參數（如適用）。這些值可能會影響計費。

如需模型特定參數與支援的工作流程，請參閱 [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md).

***

### ✅ 您已準備好開始開發

您現在已知道如何：

1. 建立 API 金鑰
2. 設定 ApiSmart API
3. 擷取可用的模型 ID
4. 送出 Chat Completions 請求
5. 嘗試影像或影片生成

請繼續閱讀與您的工作流程相符的文件：

* [**API Keys**](/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue.md) — 管理並保護您的憑證
* [**模型與模型 ID**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md) — 尋找支援的模型
* [**模型定價與計費**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) — 了解模型成本
* [**API 基礎**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md) — 學習常見 API 慣例
* [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-bu-quan-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) — 建立影片生成工作流程
* [**回應模式**](/documentation/zh-tw/api-zhi-nan/hui-ying-mo-shi.md) — 了解標準、串流與非同步回應