Paper Instruments
Ultramarine API

Billing

Token prices, prepaid funds, and usage.

Add funds on the console's Billing page to prepay for token usage.

Prices

Token typePrice per 1M tokens
Input$0.15
Cached input$0.03
Output, including reasoning$0.50

20,000 uncached input tokens and 1,000 output tokens cost $0.0035. GET /v1/pricing returns the current rates without authentication.

Request charges

We reserve the request's maximum cost before generation. We return 429 insufficient_quota if your balance cannot cover the reservation. Set max_completion_tokens to bound output cost; omission reserves funds for the full output ceiling.

We charge token usage and release unused funds, including for interrupted requests. If usage is unavailable, reserved funds remain unavailable until the request's usage is confirmed.

Funds and usage

Pay through Stripe Checkout. We credit your balance after verifying payment. Enable auto top-up on Billing to replenish funds from a saved card.

In the console, filter usage by All usage, Feather app, All API keys, or an individual key.

Call GET /v1/usage with an API key for organization usage in the current UTC calendar month. Read balances from available_nanodollars and reserved_nanodollars (1 USD = 1,000,000,000 nanodollars).

On this page