> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 無料モデル

> トークン単位の料金なしで呼び出せるテキストモデルについて、見分け方、呼び出せる人、上限を説明します。

# 無料モデル

ID が `-free` で終わるモデルは無料で、トークン単位の料金がありません。無料モデルはそれぞれ有料の兄弟モデルとは別の ID なので、`-free` 付きの正確な ID を送信してください。

* 無料のテキストモデルは下記の 5 つです。加えて、[Decisions API](/decisions) の `jev-1.14-free` も無料です。画像・動画モデルに無料 ID はありません。
* グループが無料グループに到達できるキーなら、既定の `auto` グループを含め、残高が 0 でも、初回チャージの前でも、どのキーでも呼び出せます。
* 各アカウントの上限は、初回チャージ前は毎分 1 回、チャージ後は毎分最大 10 回の成功リクエストです。
* 無料モデルは、いつでもレート制限されたり、提供を終了したりすることがあります。無料モデルに依存する本番経路を構築しないでください。

## モデル ID

公開カタログ（`GET /v1/text/models`、ファミリー `free`）の一覧です。

| 無料モデル ID                                                                     | 有料の兄弟モデル                 | ファミリーのページ                                       |
| ---------------------------------------------------------------------------- | ------------------------ | ----------------------------------------------- |
| [`glm-5.3-free`](/text-api/glm/chat-completions)                             | `glm-5.3`                | [GLM](/text-api/glm/chat-completions)           |
| [`glm-5.3-flash-free`](/text-api/glm/chat-completions)                       | `glm-5.3-flash`          | [GLM](/text-api/glm/chat-completions)           |
| [`deepseek-v4.1-flash-free`](/text-api/deepseek/chat-completions)            | `deepseek-v4.1-flash`    | [DeepSeek](/text-api/deepseek/chat-completions) |
| [`deepseek-v4-flash-0731-free`](/text-api/deepseek/chat-completions)         | `deepseek-v4-flash-0731` | [DeepSeek](/text-api/deepseek/chat-completions) |
| `gemini-3.8-flash-free`（[Gemini](/text-api/gemini/chat-completions) のページを参照） | `gemini-3.8-flash`       | [Gemini](/text-api/gemini/chat-completions)     |

有料の兄弟モデルの ID を送ると、別の課金対象リクエストになります。

## 呼び出せる人

* グループが無料グループに到達できる有効なキーならどれでも。既定の `auto` グループのキーは到達できます。
* 残高が 0 でも、一度もチャージしていないアカウントでも問題ありません。
* レスポンスの `model` フィールドには `-free` 付きの名前が入ります。

無料クレジットのアカウントが呼び出せるのは無料ティアのリストにあるモデルのみで、無料 ID はそのリストに含まれます。`GET /v1/free-tier` は、キーなしでそのリストを返します。チャージすると制限は解除されます。

## 上限

| アカウントの状態   | 毎分の成功リクエスト数 |
| ---------- | ----------- |
| 初回チャージ前    | 1           |
| いずれかのチャージ後 | 最大 10       |

* 上限は成功したリクエストを数えます。失敗したリクエストや、失敗したストリームは枠を返します。上限は呼び出しの頻度を制限するもので、同時に実行できる呼び出しの数ではありません。
* 無料の呼び出しは有料の上限とは別に数えられるため、有料の上限を消費せず、有料の上限に消費されることもありません。
* アカウントのその分の通常の上限を使い切っている場合は、無料モデルも拒否されることがあります。

上限に達すると、`Retry-After` ヘッダーと `retry_after_seconds` 付きで `429 rate_limit_exceeded` が返ります。再試行する前にその秒数だけ待ってください。メッセージは上限を示します。一度もチャージしていないアカウントでの正確な文は次のとおりです。

```json
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded: this model allows at most 1 successful requests per minute per account. Retry after 60 seconds. Accounts that have topped up get a higher per-minute limit.",
    "retryable": true,
    "request_id": "req_abc123",
    "retry_after_seconds": 60
  }
}
```

チャージ後のメッセージは `at most 10 successful requests per minute` となり、最後の文はなくなります。コードは通常のアカウント上限と同じものなので、区別するにはメッセージを読んでください。`Retry-After` / `retry_after_seconds` の秒数だけ待ってから再試行してください。[Errors](/errors#text-endpoints) を参照してください。

## 有料モデルとの違い

* **コンテキストや出力の上限は非公開。** カタログの無料エントリには、コンテキストウィンドウ、出力上限、料金がありません。有料の兄弟モデルのコンテキストウィンドウと出力上限は、無料 ID には保証されません。
* **reasoning は保証されない。** `thinking` や `reasoning_effort` など有料限定のオプションは、有料モデルと同じように動作しない場合があります。
* **形式が異なる場合がある。** たとえば `glm-5.3-free` は `/v1/responses` に対応していません。Chat Completions 以外の形式を使う前に、ファミリーのページを確認してください。
* **速度と可用性が異なる場合がある。** 無料モデルは遅い、レート制限される、予告なく提供終了になるといったことがあり、1 日あたりの利用枠も保証されません。
* **キャッシュ入力の料金はない。** 無料 ID はトークン単位ではまったく課金されません。

## 試してみる

**`cURL`**

```bash title="cURL"
curl --request POST \
  --url https://api.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "glm-5.3-flash-free",
  "messages": [{ "role": "user", "content": "Say hello in one sentence." }]
}'
```

## 画像と動画

無料の画像・動画モデルはありません。これらのモデルはタスクごとに課金されます。[クイックガイド](/quick-guide)を参照してください。