Credits and billing
Estimate a request's cost and interpret the billing information it returns.
Verification prices
JSON and streaming verification use the same fixed prices. Cached and uncached requests have the same price. There is no additional API operation charge.
| Include stance | Include verdict | Credits per request |
|---|---|---|
false | false | 2 credits |
true | false | 3 credits |
false | true | 4 credits |
true | true | 4 credits (default) |
A verdict requires stance analysis internally, even when the response omits stance fields. include_numeric_assess on JSON verification does not add a separate charge.
Prices for every endpoint
| Endpoint | Credits |
|---|---|
| POST /api/v1/verify | 2 credits for search only; 3 with stance; 4 with a verdict. No additional operation charge. Filed-folder verification with evidence_scope uses 0 credits. |
| POST /api/v1/verify/stream | Same 2/3/4-credit prices as JSON verification. |
| POST /api/v1/verify/batch | 1 credit per item, up to 200 items. |
| POST /api/v1/verify/feedback | 1 credit. |
| POST /api/v1/sources/search | 2 credits. |
| GET /api/v1/citations | 1 credit. |
| GET /api/v1/citations/{id} | 1 credit. |
| POST /api/v1/citations/source-preview | 1 credit. |
| POST /api/v1/upload | 1 credit for a successful upload. |
| POST /api/v1/upload/url | 1 credit, charged only when the file is stored. |
| POST /api/v1/extract | 1 credit for a billable extraction outcome. |
| POST /api/v1/extract/visual-rendition | 1 credit for a billable extraction outcome, the same as text extraction. |
| POST /api/v1/extract/pages | 1 credit for a billable extraction outcome. |
| POST /api/v1/classify | 1 credit for a billable classification outcome. |
| POST /api/v1/gaps | 1 credit. |
| POST /api/v1/ask | 5 credits after a completed billable job. Admission and polling are free; failed drafts and empty retrievals do not charge customer credits. |
| GET /api/v1/ask/{id} | 0 credits. |
| POST /api/v2/sources | No fixed public credit price is specified for this V2 operation. |
| POST /api/v2/sources/{versionId}/representations/text | No model call or fixed public credit price is specified. |
| GET /api/v2/sources/{versionId}/representations/latest | No fixed public credit price is specified for this V2 read. |
| GET /api/v2/sources/{versionId}/representations/{representationId}/units/{unitId} | No fixed public credit price is specified for this V2 read. |
| POST /api/v2/sources/{versionId}/representations/{representationId}/prepare-ocr-rescue | 5 credits for a new successful judged preparation; retained replays do not charge again. A dispatched outcome that cannot be confirmed remains pending reconciliation. |
| POST /api/v1/extract/figures | 2 credits for a billable extraction outcome. |
| POST /api/v1/analyze/conflicts | 1 credit. |
| POST /api/v1/analyze/document | 3 credits. |
| POST /api/v2/verify/numeric | No fixed public credit price is specified for this V2 operation. |
| GET /api/v1/accuracy | 1 credit. |
Document extraction and classification inspect the outcome before billing. Unsupported/error outcomes and partial outcomes without readable evidence are not charged. A useful partial result can be billable.
V2 numeric verification does not publish a fixed credit price. OCR preparation costs 5 credits for a new successful preparation; retained replays do not charge again. Do not assume V2 operations have the V1 price or a universal receipt shape.
Read billing receipts
V1 object responses that use the billing wrapper include operation_id and usage.credits. null means the accounting value is unavailable, not that the work was free. A returned 0 is a known zero deduction.
{"operation_id":"EXAMPLE_OPERATION_ID","usage":{"credits":4}}This is an illustrative receipt. Preserve missing and null values when you store it. Streaming sends a separate usage event; an accounting_error means accounting did not complete normally.
Batch verification returns a result array. Citation list/get, feedback, and upload retain their own response shapes and do not universally add this object receipt. Free ask polling returns the job view. Do not require a top-level receipt on every endpoint.
The current streaming receipt has a legacy zero fallback when the deduction value is unavailable. A zero in an SSE usage event alone does not establish a free operation. Retain the operation ID and reconcile it with your account usage.
Verification responses can include usages, which reports the input, output and total tokens of the model calls the request made. It is not a credit charge; credits are reported separately. usage_unknown: true means a model call could not be measured, so the totals are a lower bound. cached: true means the response came from the server cache and spent no tokens.
Manage your plan
The Free plan includes 100 credits each month. See pricing for paid plan allocations and subscription prices. Manage credits and overage settings in your account. Repeating a successful request can incur another charge; store completed results and avoid automatic replay after an ambiguous timeout.