> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pylva.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create custom pricing

> Create a custom pricing row for an LLM model or non-LLM metric.

Creates a custom pricing row. This endpoint requires an Admin API key and records an audit log entry.

## Request

```json theme={null}
{
  "provider": null,
  "model": null,
  "metric": "search_requests",
  "price_per_unit_usd": 0.01,
  "effective_from": "2026-06-11T00:00:00.000Z",
  "source": "builder_manual",
  "notes": "Search API list price."
}
```

For LLM pricing, send `provider` and `model` and leave `metric` null:

```json theme={null}
{
  "provider": "openai",
  "model": "gpt-4o-mini",
  "metric": null,
  "price_per_unit_usd": 0,
  "input_per_1m_usd": 0.15,
  "output_per_1m_usd": 0.6,
  "effective_from": "2026-06-11T00:00:00.000Z",
  "source": "builder_manual"
}
```

## Response

```json theme={null}
{
  "id": "00000000-0000-0000-0000-000000000000"
}
```

## Notes

* Set either `(provider + model)` or `metric`, not both.
* Duplicate effective pricing rows return a validation error.
* Pricing changes can affect margin reports and billing workflows.