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

# 快速入門

只需幾個步驟即可開始使用 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-bing-liao-jie-qian-bao-dian-shu.md).

***

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

登入 ApiSmart Console，然後前往：

**Console → API 金鑰**

點選 **建立 API 金鑰** 並為你的應用程式建立憑證。

API 金鑰用於驗證 API 請求。

在本文件中，我們使用：

`<your-api-key>`

送出請求時，請以你的實際 API 金鑰取代此佔位符。

> 請妥善保管你的 API 金鑰。不要將其暴露在公開儲存庫、瀏覽器端程式碼或其他可公開存取的位置。

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

***

### 🔗 第 2 步：設定 API

標準的 ApiSmart API 基礎 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-ding-jia/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,
    "resolution": "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 金鑰**](/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) — 學習常見的 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) — 建立影片生成工作流程
* [**回應模式**](/documentation/zh-tw/api-zhi-nan/hui-ying-mo-shi.md) — 了解標準、串流與非同步回應