Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.portkey.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Pricing Adjustments let you apply a discount or markup to an Integration, so cost tracking reflects your effective rate with that provider. A multiplier of 1 leaves pricing unchanged. 0.8 applies a 20% discount. 1.2 applies a 20% markup.
Requires:
  • Gateway version 2.7.0 or higher
  • Backend version 1.15.0 or higher (for air-gapped deployments)
  • Frontend version 1.8.1 or higher (for air-gapped deployments).
This is especially useful for:
  • Negotiated Discounts: Reflect enterprise contracts or committed-use rates from a provider on the corresponding Integration.
  • Internal Cost Showback: Apply a markup so the cost reported to internal teams or workspaces includes your platform overhead.
  • Custom Per-Integration Rates: Maintain different effective pricing across multiple Integrations of the same provider (e.g. a discounted production Integration alongside a standard-rate sandbox).

​
Adding Pricing Adjustments to an Integration

You can configure Pricing Adjustments directly from your Portkey dashboard, in the Basic Integration Details step.
Pricing Adjustments section in the Add Integration form
  1. Navigate to the relevant Integration in your Portkey account, and create a new Integration or open an existing one.
  2. On the Integration Details step, toggle Pricing Adjustments on.
  3. Choose a Multiplier mode:
    • Default: Quick form for the most common token types.
    • Custom: JSON editor for the full multiplier shape, including reasoning, audio, image, and additional units.
  4. Enter your multipliers. Empty fields inherit from Default.
  5. Save the Integration.
For a discount, convert the percentage to a multiplier with:multiplier = 1 - (discount% / 100)Example: a 10% discount on Default and a 15% discount on Request Tokens:
  • Default → 1 - (10 / 100) = 0.90
  • Request Tokens → 1 - (15 / 100) = 0.85
Request Tokens use 0.85; Response Tokens, Cache Read Tokens, and Cache Write Tokens inherit 0.90 from Default.

​
Configuration Fields

Default mode exposes the five most common multipliers:

Default

Multiplier applied to every token type unless a more specific multiplier is set below. A flat 20% discount across the Integration is just 0.8 here.

Request Tokens

Multiplier applied to input/request token cost.

Response Tokens

Multiplier applied to output/response token cost.

Cache Read Tokens

Multiplier applied to cache-read input token cost.

Cache Write Tokens

Multiplier applied to cache-write input token cost.
For other token types — reasoning, audio/image/text variants, image generation, or per-unit charges like web_search — switch to Custom mode and provide a JSON object with the keys you want to adjust: 
{
  "multiplier": {
    "default": 0.8,
    "request_token": 0.7,
    "response_token": 0.9,
    "reasoning_token": 0.5,
    "image": { "default": 0.9 },
    "additional_units": { "web_search": 0.7 }
  }
}
The multiplier keys mirror the pricing keys in Portkey Models — the open-source pricing database backing Portkey’s cost tracking. Any key present in a model’s pay_as_you_go (or in additional_units) can be adjusted here.
FieldApplies to
defaultEvery token type unless a more specific multiplier is set
request_token / response_tokenStandard input and output tokens
cache_read_input_token / cache_write_input_tokenPrompt cache reads and writes
reasoning_tokenReasoning/thinking tokens
request_audio_token / response_audio_token / cache_read_audio_input_tokenAudio modality tokens
request_text_token / response_text_token / cache_*_text_input_tokenText-modality breakdowns where the provider reports them separately
request_image_token / response_image_token / cache_*_image_input_tokenImage-modality breakdowns
prediction_accepted_token / prediction_rejected_tokenPredicted-output tokens
image.defaultPer-image generation pricing across all qualities and sizes
additional_units.<key>Per-unit charges such as web_search, file_search, input_image, input_video_standard. See Additional Units Reference.

​
Setting Pricing Adjustments via the API

You can also configure Pricing Adjustments programmatically through the Integrations API. Pass pricing_adjustments when creating or updating an Integration. Send null to clear all adjustments. 
curl -X PUT https://api.portkey.ai/v2/integrations/{integrationId} \
  -H "Content-Type: application/json" \
  -H "x-portkey-api-key: YOUR_PORTKEY_API_KEY" \
  -d '{
    "pricing_adjustments": {
      "multiplier": {
        "default": 0.8,
        "cache_read_input_token": 0.9,
        "cache_write_input_token": 0.9
      }
    }
  }'
Once saved, Portkey applies the multipliers to the base pricing for every subsequent request through this Integration, and the adjusted cost flows into logs, analytics, and budget tracking.
Last modified on May 7, 2026