Error
A valid request URL is required to generate request examples{
"pricing_overrides": [
{
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"virtual_key_id": "<string>",
"provider_id": "<string>",
"provider_key_id": "<string>",
"pattern": "<string>",
"request_types": [],
"pricing_patch": "<string>",
"patch": {
"input_cost_per_token": 1,
"output_cost_per_token": 1,
"input_cost_per_token_batches": 1,
"output_cost_per_token_batches": 1,
"input_cost_per_token_priority": 1,
"output_cost_per_token_priority": 1,
"input_cost_per_token_flex": 1,
"output_cost_per_token_flex": 1,
"input_cost_per_token_fast": 1,
"output_cost_per_token_fast": 1,
"input_cost_per_character": 1,
"input_cost_per_token_above_128k_tokens": 1,
"input_cost_per_image_above_128k_tokens": 1,
"input_cost_per_video_per_second_above_128k_tokens": 1,
"input_cost_per_audio_per_second_above_128k_tokens": 1,
"output_cost_per_token_above_128k_tokens": 1,
"input_cost_per_token_above_200k_tokens": 1,
"input_cost_per_token_above_200k_tokens_priority": 1,
"output_cost_per_token_above_200k_tokens": 1,
"output_cost_per_token_above_200k_tokens_priority": 1,
"input_cost_per_token_above_272k_tokens": 1,
"input_cost_per_token_above_272k_tokens_priority": 1,
"input_cost_per_token_flex_above_272k_tokens": 1,
"output_cost_per_token_above_272k_tokens": 1,
"output_cost_per_token_above_272k_tokens_priority": 1,
"output_cost_per_token_flex_above_272k_tokens": 1,
"cache_creation_input_token_cost": 1,
"cache_read_input_token_cost": 1,
"cache_creation_input_token_cost_above_200k_tokens": 1,
"cache_read_input_token_cost_above_200k_tokens": 1,
"cache_read_input_token_cost_above_200k_tokens_priority": 1,
"cache_creation_input_token_cost_above_1hr": 1,
"cache_creation_input_token_cost_above_1hr_above_200k_tokens": 1,
"cache_creation_input_audio_token_cost": 1,
"cache_read_input_token_cost_priority": 1,
"cache_read_input_token_cost_flex": 1,
"cache_read_input_image_token_cost": 1,
"cache_read_input_token_cost_above_272k_tokens": 1,
"cache_read_input_token_cost_above_272k_tokens_priority": 1,
"cache_read_input_token_cost_flex_above_272k_tokens": 1,
"cache_creation_input_token_cost_above_272k_tokens": 1,
"cache_creation_input_token_cost_flex": 1,
"cache_creation_input_token_cost_flex_above_272k_tokens": 1,
"cache_creation_input_token_cost_priority": 1,
"cache_creation_input_token_cost_fast": 1,
"cache_creation_input_token_cost_above_1hr_fast": 1,
"cache_read_input_token_cost_fast": 1,
"input_cost_per_image": 1,
"input_cost_per_pixel": 1,
"output_cost_per_image": 1,
"output_cost_per_pixel": 1,
"output_cost_per_image_premium_image": 1,
"output_cost_per_image_above_512_and_512_pixels": 1,
"output_cost_per_image_above_512_and_512_pixels_and_premium_image": 1,
"output_cost_per_image_above_1024_and_1024_pixels": 1,
"output_cost_per_image_above_1024_and_1024_pixels_and_premium_image": 1,
"output_cost_per_image_above_2048_and_2048_pixels": 1,
"output_cost_per_image_above_4096_and_4096_pixels": 1,
"output_cost_per_image_low_quality": 1,
"output_cost_per_image_medium_quality": 1,
"output_cost_per_image_high_quality": 1,
"output_cost_per_image_auto_quality": 1,
"input_cost_per_image_token": 1,
"output_cost_per_image_token": 1,
"input_cost_per_audio_token": 1,
"input_cost_per_audio_per_second": 1,
"input_cost_per_second": 1,
"input_cost_per_video_per_second": 1,
"output_cost_per_audio_token": 1,
"output_cost_per_video_per_second": 1,
"output_cost_per_second": 1,
"search_context_cost_per_query": 1,
"code_interpreter_cost_per_session": 1,
"inference_geo_us_multiplier": 1,
"cost_per_request": 1,
"ocr_cost_per_page": 1,
"annotation_cost_per_page": 1
},
"config_hash": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"count": 123,
"total_count": 123,
"limit": 123,
"offset": 123
}{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"model_requested": "<string>",
"request_type": "<string>"
}
}Pricing Overrides
List pricing overrides
Returns all pricing overrides, optionally filtered by scope.
GET
/
api
/
governance
/
pricing-overrides
Error
A valid request URL is required to generate request examples{
"pricing_overrides": [
{
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"virtual_key_id": "<string>",
"provider_id": "<string>",
"provider_key_id": "<string>",
"pattern": "<string>",
"request_types": [],
"pricing_patch": "<string>",
"patch": {
"input_cost_per_token": 1,
"output_cost_per_token": 1,
"input_cost_per_token_batches": 1,
"output_cost_per_token_batches": 1,
"input_cost_per_token_priority": 1,
"output_cost_per_token_priority": 1,
"input_cost_per_token_flex": 1,
"output_cost_per_token_flex": 1,
"input_cost_per_token_fast": 1,
"output_cost_per_token_fast": 1,
"input_cost_per_character": 1,
"input_cost_per_token_above_128k_tokens": 1,
"input_cost_per_image_above_128k_tokens": 1,
"input_cost_per_video_per_second_above_128k_tokens": 1,
"input_cost_per_audio_per_second_above_128k_tokens": 1,
"output_cost_per_token_above_128k_tokens": 1,
"input_cost_per_token_above_200k_tokens": 1,
"input_cost_per_token_above_200k_tokens_priority": 1,
"output_cost_per_token_above_200k_tokens": 1,
"output_cost_per_token_above_200k_tokens_priority": 1,
"input_cost_per_token_above_272k_tokens": 1,
"input_cost_per_token_above_272k_tokens_priority": 1,
"input_cost_per_token_flex_above_272k_tokens": 1,
"output_cost_per_token_above_272k_tokens": 1,
"output_cost_per_token_above_272k_tokens_priority": 1,
"output_cost_per_token_flex_above_272k_tokens": 1,
"cache_creation_input_token_cost": 1,
"cache_read_input_token_cost": 1,
"cache_creation_input_token_cost_above_200k_tokens": 1,
"cache_read_input_token_cost_above_200k_tokens": 1,
"cache_read_input_token_cost_above_200k_tokens_priority": 1,
"cache_creation_input_token_cost_above_1hr": 1,
"cache_creation_input_token_cost_above_1hr_above_200k_tokens": 1,
"cache_creation_input_audio_token_cost": 1,
"cache_read_input_token_cost_priority": 1,
"cache_read_input_token_cost_flex": 1,
"cache_read_input_image_token_cost": 1,
"cache_read_input_token_cost_above_272k_tokens": 1,
"cache_read_input_token_cost_above_272k_tokens_priority": 1,
"cache_read_input_token_cost_flex_above_272k_tokens": 1,
"cache_creation_input_token_cost_above_272k_tokens": 1,
"cache_creation_input_token_cost_flex": 1,
"cache_creation_input_token_cost_flex_above_272k_tokens": 1,
"cache_creation_input_token_cost_priority": 1,
"cache_creation_input_token_cost_fast": 1,
"cache_creation_input_token_cost_above_1hr_fast": 1,
"cache_read_input_token_cost_fast": 1,
"input_cost_per_image": 1,
"input_cost_per_pixel": 1,
"output_cost_per_image": 1,
"output_cost_per_pixel": 1,
"output_cost_per_image_premium_image": 1,
"output_cost_per_image_above_512_and_512_pixels": 1,
"output_cost_per_image_above_512_and_512_pixels_and_premium_image": 1,
"output_cost_per_image_above_1024_and_1024_pixels": 1,
"output_cost_per_image_above_1024_and_1024_pixels_and_premium_image": 1,
"output_cost_per_image_above_2048_and_2048_pixels": 1,
"output_cost_per_image_above_4096_and_4096_pixels": 1,
"output_cost_per_image_low_quality": 1,
"output_cost_per_image_medium_quality": 1,
"output_cost_per_image_high_quality": 1,
"output_cost_per_image_auto_quality": 1,
"input_cost_per_image_token": 1,
"output_cost_per_image_token": 1,
"input_cost_per_audio_token": 1,
"input_cost_per_audio_per_second": 1,
"input_cost_per_second": 1,
"input_cost_per_video_per_second": 1,
"output_cost_per_audio_token": 1,
"output_cost_per_video_per_second": 1,
"output_cost_per_second": 1,
"search_context_cost_per_query": 1,
"code_interpreter_cost_per_session": 1,
"inference_geo_us_multiplier": 1,
"cost_per_request": 1,
"ocr_cost_per_page": 1,
"annotation_cost_per_page": 1
},
"config_hash": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"count": 123,
"total_count": 123,
"limit": 123,
"offset": 123
}{
"event_id": "<string>",
"type": "<string>",
"is_bifrost_error": true,
"status_code": 123,
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"event_id": "<string>"
},
"extra_fields": {
"model_requested": "<string>",
"request_type": "<string>"
}
}Authorizations
Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>.
Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.
Query Parameters
Filter by scope kind Scope that determines which requests a pricing override applies to. The virtual_key* family is checked before the user* family during cost resolution, which is checked before the provider/global scopes; within a family, more identifiers present means a more specific match.
Available options:
global, provider, provider_key, virtual_key, virtual_key_provider, virtual_key_provider_key, user, user_provider, user_provider_key Filter by user ID (for user* scopes)
Filter by virtual key ID (for virtual_key* scopes)
Filter by provider ID
Filter by provider key ID
Case-insensitive substring match against the pricing override name. A non-empty value switches the response to the paginated shape.
Maximum number of results to return. A non-empty limit, offset, or search value switches the response to the paginated shape.
Required range:
x >= 0Number of results to skip
Required range:
x >= 0Response
Successful response
When limit, offset, or search is supplied, count reflects the returned page while total_count reflects the full matching set. Otherwise (backward-compatible, non-paginated path) total_count equals count and limit/offset describe the full unpaged result.
Was this page helpful?
⌘I