Hesperan

(Docs)

Plans & billing

Every request is paid either from your plan's monthly allowance or from a prepaid balance. Failed requests are never charged.

Plans: a monthly allowance of decisions

A decision is one answered question — a request with three questions uses three. Each decision covers up to 4,000 tokens of state (about 3,000 words); longer states count once more per started block. Your plan's exact allowance, what you have used and a projection are in the console under Billing, and in the x-plan-usage header of every answer.

The allowance renews every month — also on yearly plans. For every full month you stay subscribed it grows by 5 %, up to +50 %. The bonus carries over when you change plans and resets only when you cancel.

Pay as you go: a prepaid balance

Top up from €10 and pay €0.12 per million input tokens; output is free. Billable tokens are the state once plus every question with its options once. Every answer reports your remaining balance in x-balance-remaining (in euros).

Which one pays

SituationPaid by
Allowance leftthe plan
Free plan, allowance used up, balance availablethe balance, automatically
Paid plan, allowance used up, “continue on my balance” onthe balance
Paid plan, allowance used up, the option offnobody — the request is refused with 402

The header x-billed-to tells you which one paid for an answer: plan or balance.

402 when the allowance is used up
{ "error": "plan allowance used up — upgrade, or allow pay-as-you-go from your balance in the console" }

Prices and plans are on the pricing page.