---
title: "PricingOverride"
---

A conditional override of the base pricing. An entry applies only when all of its condition fields (e.g. min_prompt_tokens, or the utc_start/utc_end time window) match the request; among applicable entries, later entries win per price key; price keys absent from an entry inherit the base price.


## Fields

| Field                                                                                                                                                                                                                                                                 | Type                                                                                                                                                                                                                                                                  | Required                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `audio`                                                                                                                                                                                                                                                               | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per audio input token                                                                                                                                                                                                                         |
| `completion`                                                                                                                                                                                                                                                          | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per token for completion (output) generation                                                                                                                                                                                                  |
| `input_audio_cache`                                                                                                                                                                                                                                                   | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per cached audio input token                                                                                                                                                                                                                  |
| `input_cache_read`                                                                                                                                                                                                                                                    | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per cached input token (read)                                                                                                                                                                                                                 |
| `input_cache_write`                                                                                                                                                                                                                                                   | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per cache-write token                                                                                                                                                                                                                         |
| `input_cache_write_1h`                                                                                                                                                                                                                                                | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per 1-hour cache-write token                                                                                                                                                                                                                  |
| `min_prompt_tokens`                                                                                                                                                                                                                                                   | *Optional[float]*                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Condition: the entry applies when the total prompt tokens of a request are strictly greater than this threshold                                                                                                                                                       |
| `prompt`                                                                                                                                                                                                                                                              | *Optional[str]*                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Overridden price in USD per token for prompt (input) processing                                                                                                                                                                                                       |
| `utc_end`                                                                                                                                                                                                                                                             | *Optional[float]*                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Condition: exclusive end of a daily UTC time window as an HHMM clock number (e.g. 400 = 04:00)                                                                                                                                                                        |
| `utc_start`                                                                                                                                                                                                                                                           | *Optional[float]*                                                                                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                    | Condition: inclusive start of a daily UTC time window as an HHMM clock number (e.g. 100 = 01:00, 1030 = 10:30). The entry applies while the current UTC time is inside the half-open window [utc_start, utc_end), which may wrap past midnight (utc_start > utc_end). |