OpenAPI 3.1.0raw.githubusercontent.com2026-08-20135166549.8 KB

cea76e85cdac

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, resolution prefers the canonical one so the other sits dormant until the first is deleted, and the batched tool-rate lookup matches only the canonical form, so a tool priced under the slash spelling would pass the require-pricing gate and then settle at zero.

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