> 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/shuo-ming-yu-zi-yuan/chang-jian-wen-ti.md).

# 常見問題

尋找有關 ApiSmart API 金鑰、模型、文字、圖片與影片生成、帳單、使用量以及 API 錯誤的常見問題解答。

尋找關於使用 ApiSmart API 的常見問題快速解答。

如需詳細的整合範例，請參閱 [**快速開始**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-kai-shi.md) 或對應的 API 指南。

### 🔑 API 存取

#### ApiSmart API Base URL 是什麼？

請使用：

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

所有已驗證的請求都會在 `Authorization` 標頭中使用 API Key：

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

#### 我要在哪裡使用我的 API Key？

請在每個已驗證的 API 請求的 `Authorization` 標頭中加入您的 API Key。

請勿在前端程式碼、公開儲存庫、截圖或應用程式日誌中暴露 API Key。

請參閱 [**建立與管理 API Key**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/jian-li-bing-guan-li-api-jin-yue.md) 和 [**保護您的 API Key**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/bao-hu-nin-de-api-jin-yue.md).

#### 為什麼我會收到 `401 invalid_api_key`?

這表示無法驗證您的 API Key。

請檢查金鑰是否正確，且您的標頭使用：

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

如需更多說明，請參閱 [**API Key 與驗證問題**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/api-jin-yue-yu-yan-zheng-wen-ti.md).

### 🧩 模型

#### 我要如何找到可用的模型 ID？

請呼叫：

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

請在您的 API 請求中使用返回的 `data[].id` 值。

#### 為什麼模型 ID 必須完全一致？

ApiSmart 會精確比對模型 ID。句點、連字號與版本號都不能更改。

例如：

```
glm-5.1
gpt-5.6-luna
doubao-seedance-2-0-fast
```

模型 ID 拼寫錯誤可能會導致非預期的 `503`，因此請逐字元確認模型 ID。

#### 為什麼我會得到 `403 model_not_allowed` 即使模型出現在 `/v1/models`?

`GET /v1/models` 回傳系統模型清單，但並非每個模型都一定會對每個 API Key 啟用。

一個 `403 model_not_allowed` 回應表示目前所選模型無法供您的帳戶或 API Key 使用。

請參閱 [**模型與模型 ID**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md) 詳情。

### 💬 文字生成

#### 文字模型應該使用哪個端點？

請使用：

```
POST /v1/chat/completions
```

ApiSmart 文字模型使用與 OpenAI 相容的 Chat Completions 請求格式。

#### Chat Completions 支援串流嗎？

是。

加入：

```json
{
  "stream": true
}
```

到請求本文中即可啟用串流輸出。

請參閱 [**Chat Completions API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/liao-tian-bu-quan-api.md) 和 [**回應模式**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/hui-ying-mo-shi.md).

### 🖼️ 圖片生成

#### 圖片生成需要多久？

預設情況下，圖片生成是同步的。

單張圖片通常需要約 **20–40 秒**。高解析度、多參考或連續圖片生成可能需要更久。

請將您的用戶端逾時至少設定為 **90 秒**.

#### 我可以使用參考圖片嗎？

是。

圖片生成 API 支援：

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

最多支援 **14 張參考圖片** ，但仍受文件中所述的圖片限制約束。

請參閱 [**圖片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md) 完整需求。

#### 我可以上傳本地圖片嗎？

是。

請使用：

```
POST /v1/images/edits
```

並使用 multipart form data。

每張上傳圖片不得超過 **10 MB**，且最多支援 14 張參考圖片。

#### 我可以在哪裡找到先前生成的圖片？

請使用：

```
GET /v1/images
```

以擷取最近的圖片生成歷史。

目前歷史 API 只允許查詢最近的 **7 天**.

請參閱 [**生成媒體歷史**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/sheng-cheng-mei-ti-li-shi.md).

### 🎬 影片生成

#### 影片生成是同步的嗎？

否。

影片生成使用非同步任務工作流程：

```
POST /v1/video/tasks
        ↓
接收任務 ID
        ↓
GET /v1/video/tasks/{id}
```

您的應用程式應先建立任務，然後輪詢其狀態直到生成完成。

#### 我會收到哪些影片任務狀態？

可能的狀態包括：

| 狀態          | 意義     |
| ----------- | ------ |
| `queued`    | 在佇列中等待 |
| `running`   | 生成進行中  |
| `succeeded` | 生成完成   |
| `failed`    | 生成失敗   |
| `cancelled` | 任務已取消  |
| `expired`   | 任務已過期  |

當任務處於 `queued` 或 `running`.

#### 為什麼我應該明確指定影片解析度和時長？

影片計費與支援設定會因模型而異。

例如，HappyHorse 的預設為 **1080p 計費** 當未指定解析度時，以及 **5 秒** 當未指定時長時。Seedance 使用不同的解析度規則。

為避免非預期費用或不支援的設定，請在建議時明確指定這些參數。

請參閱 [**影片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md) 和 [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md).

#### 我可以在哪裡找到先前生成的影片？

請使用：

```
GET /v1/videos
```

該端點會回傳最近完成且成功的影片生成。

目前只能查詢最近的 **7 天** ，且不包含佇列中、執行中或失敗的任務。

若要查看進行中的任務，請改用 `GET /v1/video/tasks/{id}` 。

### 💰 計費與用量

#### API 請求如何計費？

計費取決於所選模型與工作負載。

文字、圖片與影片模型可能使用不同的計費方式。圖片生成可能依交付的圖片結果計費，而影片價格則可能取決於模型、時長、解析度或生成的 token。

如需目前的價格與計費規則，請參閱 [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md).

#### 什麼是 `402 insufficient_quota` 的意思？

您的帳戶沒有足夠的可用餘額來完成此請求。

重試前請檢查您的錢包餘額與最近用量。

請參閱 [**餘額與用量限制問題**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/yueyu-shi-yong-xian-zhi-wen-ti.md).

#### 什麼是 `429 rate_limit_error` 的意思？

已達到服務速率限制。

請降低請求頻率，並使用受控退避在稍後重試。這不表示您的錢包餘額不足。

### ⚠️ 錯誤與疑難排解

#### 如果我收到 `502`, `503`，或 `504`?

這些錯誤可能表示暫時性的供應商、閘道或網路層問題。

請使用受控重試與指數退避。如果回應包含 `Retry-After`，請在適用時遵循。

針對意外的 `503`，也請先確認模型 ID。

請參閱 [**逾時與連線問題**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/yu-shi-yu-lian-xian-wen-ti.md).

#### 我可以在哪裡查看失敗的請求與費用？

使用 [**使用記錄與費用**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) 來檢視請求層級資訊，例如模型、狀態、消耗、費用與 Request ID。

當您就 API 請求聯絡 ApiSmart 支援時，請提供相關的 **Request ID** （若可用）。

切勿提供您的完整 API Key。

### ➡️ 需要更多幫助？

繼續閱讀：

* [**快速開始**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-kai-shi.md) — 發送您的第一個 API 請求
* [**模型與模型 ID**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md) — 尋找有效的模型
* [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) — 了解 API 成本
* [**使用記錄與費用**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) — 檢視請求活動
* [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md) — 查詢 API 錯誤
* [**聯絡支援**](https://docs.apismart.ai/documentation/zh-tw/shuo-ming-yu-zi-yuan/lian-luo-zhi-yuan.md) — 取得額外協助
