> 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/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md).

# 模型價格與計費

了解 ApiSmart 如何對文字、圖片與影片模型計費，包括依 token 計價、每張圖片費用、影片解析度與時長，以及如何檢視您的實際 API 成本。

ApiSmart 採用 **按用量付費** 計費模式。費用會根據每次 API 請求所使用的模型與工作負載，從您可用的錢包餘額中扣除。

不同的模型類型使用不同的計費方式：

| 工作負載          | 典型計費依據             |
| ------------- | ------------------ |
| 文字生成          | 輸入與輸出 token        |
| 圖片生成          | 成功交付的圖片            |
| HappyHorse 影片 | 影片時長與解析度           |
| Seedance 影片   | 生成的 token、解析度與輸入類型 |

模型可用性與價格可能會隨時間變動。若要估算正式環境成本，請務必確認 ApiSmart Console 或目前模型定價介面中顯示的最新價格。

### 💬 文字模型計費

文字模型通常依 token 使用量計費。

一次請求可能包含：

* **輸入 token** — 傳送給模型的 token
* **輸出 token** — 模型生成的 token
* **快取輸入** — 在支援的情況下，快取 token 可能會使用不同價格
* 其他適用的模型特定計費類別

簡化計算如下：

```
輸入成本
+
輸出成本
=
請求成本
```

例如，若某模型有分開的輸入與輸出價格：

```
輸入成本 =
input_tokens ÷ 1,000,000 × 輸入價格

輸出成本 =
output_tokens ÷ 1,000,000 × 輸出價格
```

確切價格會因模型而異。

由於文字模型價格與可用模型可能會變動，本文件不在此維護第二份靜態價格表。請在估算正式環境成本前，查看 ApiSmart 顯示的最新模型定價。

公開的 [ApiSmart 定價頁面](https://www.apismart.ai/pricing) 也將文字 API 計費說明為基於實際輸入與輸出 token 消耗的按用量付費。&#x20;

### 🖼️ 圖片生成定價

目前的 Seedream 圖片模型是：

```
doubao-seedream-5-0
```

目前文件化的價格：

| 模型                    |             價格 |
| --------------------- | -------------: |
| `doubao-seedream-5-0` | **每張圖片 $0.04** |

#### 圖片計費如何運作

圖片生成依實際成功交付的圖片數量計費。

例如：

```
1 張成功交付的圖片 × $0.04 = $0.04
```

如果一次連續生成請求成功交付四張圖片：

```
4 × $0.04 = $0.16
```

回應可能包含：

```json
{
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}
```

對於圖片計費，最終收費是根據 **實際交付且去重後的圖片結果**，而不是單純使用回報的 token 數量或預期輸出數。

這在使用連續圖片生成時尤其重要，因為一次請求可能會回傳多張圖片。

### 🎬 影片生成定價

影片價格取決於所選的模型系列。

ApiSmart 目前文件化了兩種不同的影片計費模型：

**HappyHorse** — 依影片時長與解析度計費\
**Seedance** — 依生成的 token 計費，價格會受解析度以及請求是否包含影片輸入影響

***

### HappyHorse 定價

支援的模型：

```
happyhorse-1.0
happyhorse-1.1
```

目前文件化的價格：

| 模型               |      720p |    1080p |
| ---------------- | --------: | -------: |
| `happyhorse-1.0` | 每秒 $0.145 | 每秒 $0.27 |
| `happyhorse-1.1` | 每秒 $0.145 | 每秒 $0.24 |

基本計算如下：

```
影片成本 =
秒數 × 每秒價格
```

例如，一段 5 秒的 `happyhorse-1.0` 720p 影片成本為：

```
5 × $0.145 = $0.725
```

#### 明確指定解析度與時長

HappyHorse 有重要的預設計費行為。

如果未提供解析度設定，計費將預設為 **1080p**.

如果未提供 `時長` ，計費將預設為 **5 秒**.

例如，若為 `happyhorse-1.0`:

```
1080p × 5 秒
=
$0.27 × 5
=
$1.35
```

相較之下，明確請求 720p 與 5 秒的費用為：

```
$0.145 × 5
=
$0.725
```

為了在整份 ApiSmart 文件中保持一致，HappyHorse 請求範例使用：

```json
{
  "model": "happyhorse-1.0",
  "prompt": "夜晚的電影感城市",
  "duration": 5,
  "size": "720P"
}
```

最新的 API 規格也在其主要的 HappyHorse 請求範例中使用 `size: "720P"` 。

> **請務必明確指定 HappyHorse 的輸出尺寸與時長。**\
> 依賴預設值可能會導致費用高於預期。

### Seedance 定價

支援的模型包括：

```
doubao-seedance-2.0
doubao-seedance-2-0-fast
doubao-seedance-2-0-mini
doubao-seedance-2-5
```

Seedance 依 **生成的 token**.

計費。價格也取決於：

* 模型
* 解析度等級
* 請求是否包含影片輸入

目前文件化的價格如下。

#### 無影片輸入 / 有影片輸入

每個表格儲存格顯示：

```
無影片輸入 / 有影片輸入
```

價格單位為 **每 100 萬生成 token 的 USD**.

| 模型                         |           480p |           720p |          1080p |
| -------------------------- | -------------: | -------------: | -------------: |
| `doubao-seedance-2-5`      | $13.99 / $8.49 | $13.99 / $8.49 |            不支援 |
| `doubao-seedance-2.0`      | $10.40 / $6.30 | $10.40 / $6.30 | $11.50 / $6.90 |
| `doubao-seedance-2-0-fast` |  $7.49 / $4.49 |  $7.99 / $4.99 | $10.99 / $6.99 |
| `doubao-seedance-2-0-mini` |  $2.49 / $1.49 |  $2.79 / $1.69 |  $3.79 / $2.29 |

例如，以下兩個值：

```
$10.40 / $6.30
```

表示：

```
每 100 萬生成 token $10.40
無影片輸入

每 100 萬生成 token $6.30
有影片輸入
```

#### Seedance 成本公式

計算如下：

```
成本 =
生成的 token ÷ 1,000,000 × 適用價格
```

可從已完成的影片任務回應中取得生成的 token 使用量，包括：

```
usage.completion_tokens
```

#### 解析度預設值

如果 `解析度` 未在 Seedance 請求中省略，計費將預設為 **720p 等級**.

例如：

```json
{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "一隻貓在日落時沿著海灘奔跑"
    }
  ],
  "duration": 4,
  "resolution": "720p"
}
```

Seedance 目前不支援 `4k`.

此外：

```
doubao-seedance-2-5
```

僅支援：

```
480p
720p
```

使用不支援解析度的請求可能會回傳：

```
400 unsupported_resolution
```

### 📊 計費差異一覽

| 模型類型       | 主要決定成本的是什麼？            |
| ---------- | ---------------------- |
| 文字         | 輸入/輸出 token 與模型定價      |
| Seedream   | 實際交付圖片數量               |
| HappyHorse | 解析度 × 時長               |
| Seedance   | 生成的 token × 解析度/輸入特定價格 |

在閱讀 **使用記錄**.

像是 `消耗量` 這樣的欄位時，不應一律解讀為文字 token，因為不同工作負載使用不同的計費單位。

### 💳 錢包與餘額

ApiSmart 使用預付錢包系統。

在資金或錢包額度可用後，API 使用量會依適用的模型定價從帳戶餘額中扣除。

公開定價頁面目前區分了實際支付金額與入帳至錢包的金額，包括適用時的促銷額度。&#x20;

如果您的可用餘額不足，API 請求可能會回傳：

```
402 insufficient_quota
```

請先加值再重新嘗試該請求。

如需錢包詳細資訊，請參閱 **加值與了解錢包額度**.

### 🔎 檢視實際請求成本

若要了解某個特定請求的成本，請開啟：

**Console → 使用記錄**

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2FwOQkyYYrOUx09fnk34Il%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_200442.png?alt=media&amp;token=bf4a6e0a-799e-40a6-8896-0b34bdcfec5f" alt=""><figcaption></figcaption></figure>

檢查對應的：

* 請求 ID
* 模型
* 計費模式
* 消耗量
* 成本
* 狀態

對於生成的圖片與影片，您也可以檢視 [**生成媒體歷史**](/documentation/zh-tw/api-shi-yong-liang/sheng-cheng-mei-ti-li-shi.md).

影片歷史記錄包含成功生成的實際成本，以及模型、時長與解析度資訊。

### ⚠️ 避免意外成本

在送出正式環境請求之前：

1. 確認正確的模型。
2. 檢視其目前價格。
3. 明確指定 HappyHorse `尺寸` 與 `時長`.
4. 明確指定 Seedance `解析度` （如適用）。
5. 請檢查 Seedance 是否包含影片輸入，因為這可能會使用不同費率。
6. 將連續圖片生成限制在您實際需要的圖片數量內。
7. 在未確認客戶端逾時前是否已完成的情況下，避免在逾時後自動重新送出請求。

尤其是對同步圖片生成而言，客戶端逾時並不一定代表生成失敗。API 規格建議客戶端逾時至少設為 90 秒，因為即使客戶端過早斷線，生成仍可能完成並產生費用。

### 🔄 價格變動

模型價格、可用性、支援的解析度與供應商設定都可能變動。

API 規格明確指出，最終模型價格應以目前線上設定以及請求送出時鎖定的價格為準。

因此：

> **在估算正式環境成本時，請使用目前的 ApiSmart Console 或模型定價介面作為唯一準據。**

不要長期依賴舊截圖、快取文件或先前記錄的模型價格來做預算。

### ✅ 計費檢查清單

在部署整合之前，請確認模型 ID、目前價格、計費單位，以及任何會影響成本的模型特定預設值。

部署後，請使用 [**使用記錄與成本**](/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) 來監控實際收費並調查異常使用。

### ➡️ 下一步

* [**模型與模型 ID**](/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md) — 找出支援的模型與確切的模型 ID
* [**使用記錄與成本**](/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) — 檢視請求層級的消耗與成本
* [**生成媒體歷史**](/documentation/zh-tw/api-shi-yong-liang/sheng-cheng-mei-ti-li-shi.md) — 檢視圖片與影片生成歷史
* [**加值與了解錢包額度**](/documentation/zh-tw/zhang-hu-yu-qian-bao/jia-zhi-yu-liao-jie-qian-baoedu.md) — 管理您的錢包
* [**餘額與使用限制問題**](/documentation/zh-tw/yi-nan-pai-jie/yueyu-shi-yong-xian-zhi-wen-ti.md) — 疑難排解 `402` 與使用限制問題
