> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 簡介

> 在你自己的程式裡，用 Blon 生成圖片、影片與聲音。

Blon API 讓你的伺服器呼叫 Blon 的圖片、影片與聲音模型。你提交一筆**工作**，Blon 交給模型的供應商執行，完成後從同一筆工作取得產物。

## 三種取用方式

> [card] [API 金鑰](https://docs.blon.ai/zh-TW/authentication.md)
>
> 伺服器對伺服器，使用 `blon_api_` 金鑰，金額以美元計。

> [card] [CLI 與 Skills](https://docs.blon.ai/zh-TW/cli.md)
>
> `blon` 指令與給 coding agent 的 Skills，以你的 Blon 帳號登入，使用帳號點數。

> [card] [MCP](https://docs.blon.ai/zh-TW/how-to/mcp.md)
>
> 以 OAuth 連接 AI 客戶端，使用帳號點數。

本文件以 API 金鑰為主線，CLI 與 MCP 各有一頁。

## Base URL

```text theme={null}
https://api.blon.ai/v1
```

## 慣例

* 請求與回應皆為 JSON。
* 欄位名稱使用 `snake_case`。
* 時間為 RFC 3339 UTC，例如 `2026-10-30T08:00:00.000Z`。
* 金額為十進位字串，例如 `"0.48"`，不使用浮點數。
* 每個回應都帶 `X-Request-Id` header，回報問題時請附上。

## 發出第一個請求

讀取餘額，確認金鑰可用：

```bash theme={null}
curl https://api.blon.ai/v1/balance \
  -H "Authorization: Bearer $BLON_API_KEY"
```

```json theme={null}
{
  "currency": "USD",
  "available": "18.425",
  "held": "0.0042",
  "usage_this_month": "1.5708",
  "spend_limit": {
    "amount": "50.00",
    "spent": "1.5708",
    "window": "month",
    "resets_at": "2026-11-01T00:00:00.000Z"
  }
}
```

> [card] [快速開始](https://docs.blon.ai/zh-TW/quickstart.md)
>
> 估價、提交工作、取得結果。

> [card] [OpenAPI 文件](https://api.blon.ai/v1/openapi.json)
>
> 「API 參考」分頁由這份文件產生；也可以直接載入你自己的工具。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.