Skip to content
Documentation/Get started

Credits and billing

Estimate a request's cost and interpret the billing information it returns.

Markdown

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 stanceInclude verdictCredits per request
falsefalse2 credits
truefalse3 credits
falsetrue4 credits
truetrue4 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

EndpointCredits
POST /api/v1/verify2 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/streamSame 2/3/4-credit prices as JSON verification.
POST /api/v1/verify/batch1 credit per item, up to 200 items.
POST /api/v1/verify/feedback1 credit.
POST /api/v1/sources/search2 credits.
GET /api/v1/citations1 credit.
GET /api/v1/citations/{id}1 credit.
POST /api/v1/citations/source-preview1 credit.
POST /api/v1/upload1 credit for a successful upload.
POST /api/v1/upload/url1 credit, charged only when the file is stored.
POST /api/v1/extract1 credit for a billable extraction outcome.
POST /api/v1/extract/visual-rendition1 credit for a billable extraction outcome, the same as text extraction.
POST /api/v1/extract/pages1 credit for a billable extraction outcome.
POST /api/v1/classify1 credit for a billable classification outcome.
POST /api/v1/gaps1 credit.
POST /api/v1/ask5 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/sourcesNo fixed public credit price is specified for this V2 operation.
POST /api/v2/sources/{versionId}/representations/textNo model call or fixed public credit price is specified.
GET /api/v2/sources/{versionId}/representations/latestNo 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-rescue5 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/figures2 credits for a billable extraction outcome.
POST /api/v1/analyze/conflicts1 credit.
POST /api/v1/analyze/document3 credits.
POST /api/v2/verify/numericNo fixed public credit price is specified for this V2 operation.
GET /api/v1/accuracy1 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.

json
{"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.