From 0a61b7aea59b08fde9c4dd2a52c8f533be479886 Mon Sep 17 00:00:00 2001
From: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
Date: Sat, 5 Sep 2026 04:15:14 -0700
Subject: [PATCH] docs(pricing): document the batch and long-context batch
 pricing keys

---
 docs/provider_registration/add_model_pricing.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/provider_registration/add_model_pricing.md b/docs/provider_registration/add_model_pricing.md
index 7cd4da8c3..a43ba5b49 100644
--- a/docs/provider_registration/add_model_pricing.md
+++ b/docs/provider_registration/add_model_pricing.md
@@ -56,6 +56,23 @@ Here's the full specification with all available fields:
 }
 ```
 
+### Batch pricing keys
+
+Batch API lines bill from the `*_batches` keys when the entry carries them. An entry without them bills half its standard rate
+
+| Key | Bills |
+| --- | --- |
+| `input_cost_per_token_batches` | prompt tokens |
+| `output_cost_per_token_batches` | completion tokens |
+| `cache_read_input_token_cost_batches` | cached prompt tokens |
+| `cache_creation_input_token_cost_batches` | cache write tokens |
+| `input_cost_per_token_above_272k_tokens_batches` | prompt tokens, prompt over 272K |
+| `output_cost_per_token_above_272k_tokens_batches` | completion tokens, prompt over 272K |
+| `cache_read_input_token_cost_above_272k_tokens_batches` | cached prompt tokens, prompt over 272K |
+| `cache_creation_input_token_cost_above_272k_tokens_batches` | cache write tokens, prompt over 272K |
+
+The `above_272k` keys apply to a batch line whose prompt exceeds 272K tokens, the long-context threshold OpenAI prices from. Any tier key the entry leaves out falls back to that entry's flat `*_batches` rate for the same tokens
+
 ### Examples
 
 #### Anthropic Claude