> 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.

# DeepSeek API

> BeatAPI で無料の DeepSeek V4.1 Flash API を利用する方法、レート制限、有料 DeepSeek モデルの明示的な選択方法を説明します。

# DeepSeek API

BeatAPI では、同じ API キーで無料版と有料版の DeepSeek API を利用できます。無料版は Responses と Chat Completions に対応し、有料モデルは Text API に記載された形式を利用できます。

| モデル                        | 適した用途                                              |
| -------------------------- | -------------------------------------------------- |
| `deepseek-v4-pro-0813`     | 高度な推論や長時間のエージェント処理で第一候補となる主力推論モデル                  |
| `deepseek-v4.1-flash-free` | V4.1 Flash の無料版。入力・出力ともに \$0 で、専用のレート制限を適用         |
| `deepseek-v4.1-flash`      | アカウント共通の有料利用枠を使用する処理向けの有料 V4.1 Flash               |
| `deepseek-v4-flash-0731`   | 大量の抽出、分類、振り分けに適した前世代の Flash                        |
| `deepseek-v4-pro-0813-hc`  | 共通のプロンプトプレフィックスを繰り返し送るエージェントや長い会話向けの高キャッシュ版 V4 Pro |
| `deepseek-v4.1-flash-hc`   | 長いプロンプトプレフィックスを共有する大量の呼び出し向けの高キャッシュ版 V4.1 Flash    |

2026 年 9 月 30 日の確認時点で、旧エンドポイント `deepseek-v4-flash-vision-exp` は現在の BeatAPI カタログに含まれていません。V4.1 Flash に自動的に切り替わる別名として扱わないでください。テキストの処理には `deepseek-v4.1-flash` を明示的に選択し、画像の処理には、代替モデルが画像入力に対応していることを確認してください。[移行のお知らせ](https://beatapi.io/deepseek-v4-flash-vision-api)。

## 無料の DeepSeek API

BeatAPI では、`deepseek-v4.1-flash-free` を通じて DeepSeek V4.1 Flash API を無料で利用できます。入力も出力も **\$0** で、チャージは不要です。デフォルトの `auto` グループで API キーを作成し、無料版のモデル ID を明示的に選択してください。

* 初回チャージ前：**アカウントごとに毎分 1 回の成功リクエスト**。
* チャージ後：**アカウントごとに毎分最大 10 回の成功リクエスト**。
* 無料版の呼び出しは、有料版のレート制限とは別にカウントされます。これはリクエスト頻度の上限であり、同時リクエスト数の上限ではありません。超過すると HTTP 429 が返ります。
* 無料版の利用可否は変わることがあり、提供が終了する場合もあります。継続利用の前に現在の提供状況を確認してください。

### エンドポイントと最初のリクエスト

ベース URL：`https://api.beatapi.io/v1`。`Authorization: Bearer <BEATAPI_API_KEY>` で認証します。

`POST /v1/responses` または `POST /v1/chat/completions` を使用してください。公開されている無料モデルの契約には、この 2 つの形式が記載されています。

```bash
curl https://api.beatapi.io/v1/responses \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash-free","input":"Explain this system clearly.","max_output_tokens":256}'
```

Chat Completions では、同じヘッダーを付けて `{"model":"deepseek-v4.1-flash-free","messages":[{"role":"user","content":"Explain this system clearly."}],"max_tokens":256}` を `https://api.beatapi.io/v1/chat/completions` に送信します。

### 無料版から有料版への切り替え

チャージすると、無料モデルの上限は毎分最大 10 回の成功リクエストに増えます。モデルが変わったり、無料の呼び出しが有料になったりすることは**ありません**。有料版を利用するには、キーとベース URL はそのままに、`model` を `deepseek-v4.1-flash` に明示的に変更してください。有料版はアカウント共通の有料利用枠を使用し、[公開料金](https://beatapi.io/deepseek-v4-1-flash-api)に従って実際のトークン使用量に基づき課金されます。

[無料 DeepSeek API の設定と料金](https://beatapi.io/deepseek-v4-1-flash-api#free-deepseek-api)。

## OpenAI Chat Completions

`POST https://api.beatapi.io/v1/chat/completions`

```typescript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BEATAPI_API_KEY,
  baseURL: "https://api.beatapi.io/v1"
});

const completion = await client.chat.completions.create({
  model: "deepseek-v4-pro-0813",
  max_tokens: 2000,
  messages: [
    { role: "user", content: "Design a resilient webhook retry strategy for a payments API." }
  ]
});

console.log(completion.choices[0].message.content);
```

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/chat/completions \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-v4-pro-0813",
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'
```

## 高キャッシュ（HC）モデル

`deepseek-v4-pro-0813-hc` と `deepseek-v4.1-flash-hc` は、それぞれ同じモデルを高キャッシュ対応の経路で提供します。長いシステムプロンプト、ツール一覧、蓄積していく会話など、リクエスト間で共通のプロンプトプレフィックスがある場合、2 回目以降はその部分がキャッシュから読み取られ、キャッシュ入力料金で課金されます。当社のテストでは、繰り返されたプレフィックスの 95% 以上にこの料金が適用されました。通常の経路はトークン単価が低い一方、キャッシュヒットは保証されません。毎回送るプロンプトの大半が共通のプレフィックスである場合は HC モデルを選び、繰り返しが少ない場合は料金の低い通常モデルを選んでください。リクエストは通常モデルと同じで、変更するのはモデル ID だけです。

## 時間帯別の料金

通常の有料モデル 3 種（`deepseek-v4-pro-0813`、`deepseek-v4.1-flash`、`deepseek-v4-flash-0731`）は、曜日や時間帯にかかわらず同じ料金で課金されます。DeepSeek が公開している平日のピーク時間帯は、これらには適用**されません**。火曜日の 10:00 でも日曜日の 03:00 でも、料金ページに表示された料金が適用されます。

HC モデル 2 種にはピーク時間帯があります。**北京時間（GMT+8）の平日 09:00–12:00 と 14:00–18:00 は、すべての料金が 2 倍**になります。入力、キャッシュ入力、出力のすべてが対象です。それ以外の時間帯、および土曜日と日曜日の終日は、[料金ページ](https://beatapi.io/pricing)に表示されたオフピーク料金が適用されます。

> **Note**
>
> 通常モデルは 2026-09-20 以降、時間帯によらない単一料金となり、同時に料金も半額になりました。それ以前のリクエストには、北京時間（GMT+8）の平日 09:00–12:00 と 14:00–18:00 に表示料金の 2 倍が適用されており、当時の利用記録には引き続き 2 倍の料金が表示されます。

通常モデル 3 種はデフォルトで推論を行います。推論に使用したトークン数は `usage.completion_tokens_details.reasoning_tokens` に報告され、`completion_tokens` に含まれ、出力として課金されます。

## その他の SDK 形式

有料モデルは `/v1/responses`、`/v1/messages`、Gemini 互換エンドポイントでも利用できます。各形式のリクエストとレスポンスの構造はテキストモデル間で共通のため、[Text API](/text-api) ページでまとめて説明しています。

## 認証と利用可能なモデル

このページの全モデルを 1 つの BeatAPI キーで利用できます。ベンダーごとのキー、ベース URL、個別の登録は不要です。`https://api.beatapi.io` へのリクエストに `Authorization: Bearer <BEATAPI_API_KEY>` を付けてください。

## 無料版

Flash モデル 2 種には、それぞれ専用のモデル ID を持つ無料版があり、`/v1/chat/completions` と `/v1/responses` で呼び出せます。`deepseek-v4-pro-0813` と HC モデルには無料版はありません。

| モデル                           | 対応する有料モデル                | 料金 |
| ----------------------------- | ------------------------ | -- |
| `deepseek-v4.1-flash-free`    | `deepseek-v4.1-flash`    | 無料 |
| `deepseek-v4-flash-0731-free` | `deepseek-v4-flash-0731` | 無料 |

> **Note**
>
> 無料版は料金なしで利用できますが、安定性は保証されません。いつでもレート制限が適用されたり、提供が終了したりする場合があり、提供期間も保証されません。1 日あたりの利用枠は動的に調整されます。無料モデルの上限は、アカウントごとに初回チャージ前が毎分 1 回の成功リクエスト、チャージ後が毎分 10 回です。