Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21163196628.8 KB

2d6e4912e230

organization-pricing

Create Organization Pricing

Set the organization's rate for a model over a period.

Refused with a 409 when the period overlaps one already stored for that model, naming the period it collides with, rather than shadowing it.

The key is normalized to its canonical instance:model form first, the same call POST /v1/pricing makes, and that is what makes one model one row rather than one per spelling. Stored verbatim, openai:gpt-4o and openai/gpt-4o are two keys: the overlap rule would not see them as colliding, and both would resolve, with the canonical one preferred, leaving the other dormant until the first is deleted. Normalizing on the way in is what stops that pair existing at all.

post/v1/organizations/me/pricing

Request body

cache_read_price_per_millionnumber nullable

Price per 1M cached-input tokens

cache_write_1h_price_per_millionnumber nullable

Price per 1M Anthropic 1-hour cache-write tokens

cache_write_price_per_millionnumber nullable

Price per 1M cache-write (creation) tokens

effective_fromstring date-time nullable

ISO 8601 datetime from which this rate applies, inclusive. Defaults to now.

effective_tostring date-time nullable

ISO 8601 datetime at which this rate stops applying, exclusive. Null leaves it open ended. Because the end is exclusive, the next period may begin at exactly this instant without overlapping.

input_price_per_millionnumber required

Price per 1M input tokens

model_keystring required

Model identifier in 'provider:model' form, matching the key the deployment price list uses. A provider instance name is valid here ('home_lab:llama-3'), because pricing keys on the instance a request resolves to.

output_price_per_millionnumber required

Price per 1M output tokens

Response

Successful Response

cache_read_price_per_millionnumber nullable required
cache_write_1h_price_per_millionnumber nullable required
cache_write_price_per_millionnumber nullable required
created_atstring date-time required
effective_fromstring date-time required
effective_tostring date-time nullable required
idstring uuid required
input_price_per_millionnumber required
model_keystring required
organization_idstring uuid required
output_price_per_millionnumber required
updated_atstring date-time required