Credit Costs

Machine-readable per-endpoint credit cost catalogue. Public, no auth, no credits charged.

Use cases:

• Build a cost calculator in your app ("this analysis will use N credits").
• Estimate monthly burn before committing to a tier.
• Drive a usage dashboard alongside /v1/usage (current spend) and /v1/pricing (tier credit allowance).

Response shape: { "currency": "credits", "version": "0.1", "fixed": [{method, path, cost, desc}, ...], "variable": [{method, path, cost_formula, cost_floor, example, desc}, ...], "free_examples": [path, ...], "notes": [...] }

Stability promise: the keys currency, version, fixed, variable, free_examples will not be removed or renamed. Per- endpoint costs may change with notice via /changelog. The version field bumps when a breaking schema change happens.

sleep_iter_21 #520: emits ETag + supports If-None-Match for 304 Not-Modified responses. SDK clients with conditional-GET wiring skip transferring the body when the cost catalogue hasn't changed since the last fetch.