---
title: "冪等キー（Idempotency Key）とは？API の安全なリトライ | BroadRouter"
description: "冪等キーは、クライアントがリクエストに付ける一意の ID です。リトライしても二重課金などの効果が繰り返されません。仕組みと IETF の Idempotency-Key ヘッダーを解説します。"
url: https://broadrouter.com/ja/glossary/idempotency-key/
lang: ja
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。 [英語の原文を読む](https://broadrouter.com/glossary/idempotency-key/) (2026-11-14 更新).

# 冪等キー（idempotency key）

更新日 2026-11-14

冪等キーとは、決済や購入など状態を変えるリクエストにクライアントが付ける一意の値で、通常は UUID などのランダムな ID です。同じキーで同じリクエストが再送されると、サーバーは処理を 2 回実行せず、最初の結果を返します。

別名： 冪等キー、べき等キー、冪等性キー、冪等性、冪等なリクエスト、Idempotency-Key ヘッダー、idempotency key、Idempotency-Key header、idempotency token、idempotent request、idempotent retry

ネットワークは最悪のタイミングで切れます。サーバーは処理を終えたのに、応答が届かないときです。冪等キーは、そこでのリトライを安全にします。

## 仕組み

クライアントは、意図した 1 つの操作に対して一意のキーを作り、リクエストと一緒に送ります。サーバーはキーを結果とともに保存します。同じキーが再び届いたら、サーバーは処理をやり直さず、保存した結果を返します。

IETF の HTTPAPI ワーキンググループは、これを `Idempotency-Key` リクエストヘッダーとして標準化しています（ドラフト 08、2026 年 10 月、まだ RFC ではありません）。ドラフトはキーを “a unique value generated by the client which the resource uses to recognize subsequent retries of the same request”（訳：クライアントが生成する一意の値で、リソースが同じリクエストの後続のリトライを識別するために使うもの）と説明し、UUID などのランダムな ID を推奨しています。ドラフトが定めるエラーは次のとおりです。

| 状況 | ステータス |
| --- | --- |
| 必須なのにキーがない | 400 Bad Request |
| 元のリクエストがまだ処理中 | 409 Conflict |
| 同じキーを別のボディで再利用 | 422 Unprocessable Content |

AWS の Builders’ Library も、クライアント側から同じことを指摘しています。“APIs with side effects aren’t safe to retry unless they provide idempotency.”（訳：副作用のある API は、冪等性を提供していない限り、安全にリトライできない）

## なぜ重要か

[指数バックオフ](https://broadrouter.com/ja/glossary/exponential-backoff/)によるリトライは標準的な手法で、多くの SDK は自動でリトライします。冪等性がなければ、タイムアウト後のリトライで注文や課金が 2 回発生することがあります。キーがあれば、最初の試行がどうなっていてもリトライは安全です。人が見ていないところで購入、予約、作成を行うエージェントやスクリプトにとって、中核となる仕組みです。

## BroadNet Inference の場合

BroadNet は[時間制キー](https://broadrouter.com/ja/blog/hourly-llm-api-key-explained/)の購入にこのパターンを使っています。`POST /portal/keys/hourly` は JSON ボディで `request_id` を受け取り、ドキュメントには “Idempotency is required for money safety”（訳：お金の安全のために冪等性が必須）と書かれています。

```bash
curl -X POST https://inference.broadnet.ai/portal/keys/hourly \
  -H "Authorization: Bearer <portal-credential>" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"order-20260920-001","label":"kiosk-1"}'
```

同じ `request_id` を再利用しても、別のキーが作られたり課金されたりはしません。タイムアウト、接続の切断、409 `mint_in_progress`、5xx の後は、同じ `request_id` でリトライしてください。再送には `already_issued: true` とキーのエイリアスが返ります。生のキーが含まれるのは、最初に成功した応答だけです。ドキュメントには “Never generate a replacement id until the original result is known.”（訳：元の結果がわかるまで、代わりの id を生成してはならない）とあります。

BroadNet は `/v1/chat/completions` や文字起こしについては冪等キーを記載していません。そちらで何をリトライすべきかは[エラーコードとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を、やみくもなリトライが 429 を悪化させる理由は[レート制限](https://broadrouter.com/ja/glossary/rate-limit/)を参照してください。

## よくある質問

### 新しい冪等キーはいつ生成すればよいですか？

新しい操作を意図したときだけです。1 つの操作のリトライには毎回同じキーを使い、最初の試行の結果がわかるまでは新しいキーを作らないでください。

### LLM のチャット補完リクエストに冪等キーは必要ですか？

テキスト生成には永続的な副作用がないため、チャットリクエストが繰り返されても、通常はトークン代が再度かかるだけです。冪等キーが重要なのは、課金やリソース作成を伴う呼び出しです。BroadNet が冪等キーを記載しているのは時間制キーの購入だけで、チャット補完にはありません。

### 同じキーを別のリクエストボディで再利用するとどうなりますか？

IETF のドラフトでは、キーがすでに別のリクエストに結び付いているため、サーバーは 422 Unprocessable Content で拒否すべきとしています。

## 関連項目

-   [指数バックオフ（exponential backoff）](https://broadrouter.com/ja/glossary/exponential-backoff/) (用語)
-   [レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/) (用語)
-   [API キー（API key）](https://broadrouter.com/ja/glossary/api-key/) (用語)
-   [同時実行数（concurrency）](https://broadrouter.com/ja/glossary/concurrency/) (用語)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/) (ガイド)
-   [IP 許可リストで API キーを自社サーバーに限定する](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/) (ガイド)
-   [長時間動くエージェント：崩れないタイムアウト、リトライ、チェックポイント](https://broadrouter.com/ja/blog/long-running-agents-timeouts-retries/) (記事)
-   [LLM API の時間制キーとは：1 時間定額の仕組みを解説](https://broadrouter.com/ja/blog/hourly-llm-api-key-explained/) (記事)

実際のワークロードで試してください。 新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-glossary-idempotency-key&utm_content=page-cta) ·

**出典**

-   [IETF HTTPAPI、The Idempotency-Key HTTP Header Field（Internet-Draft）](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)
-   [AWS Builders' Library、タイムアウト、リトライ、ジッター付きバックオフ（冪等トークン）](https://builder.aws.com/content/3EumjoZascWd1oZiEgL8ORlv3qE/timeouts-retries-and-backoff-with-jitter)
-   [BroadNet Inference API リファレンス、時間制キー（request\_id による冪等性） （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-glossary-idempotency-key&utm_content=sources#hourly-keys)
