Browse all documentation

CORE CONCEPTS

Usage and cost

Each response includes input spatial tokens, output spatial tokens, and projected input/output cost. Token charges are usage-based. The default 100,000-request owner billing-period ceiling is an abuse/safety control, not included usage, and can be adjusted for an account. Live paid API billing is available for this configured environment.

Read usage, not the docs, for your real cost

Every response carries a usage object with the exact input and output spatial-token counts you were billed for, plus projected cost. That is authoritative for a request in a way no published estimate can be, because token counts depend on your files.

What is billed

Only successful 2xx results reach the meter. Failed requests are recorded against their request_id so you can debug them, and are never billed. Uploaded file bytes count as input tokens; returned JSON counts as output.

The request ceiling is not an allowance

Accounts default to 100,000 requests per billing period. It is an abuse and safety control, not included usage, and it can be raised for an account. Hitting it is not the same as running out of credit — there is no credit.

How the pricing calculator was measured

The file calculator on the pricing page is not a guess. A sample of public, permissively licensed STEP, IGES, DXF, PDF, and SVG files was run through the Four Cad converter with the API's own accounting, and a subset was sent through the live metered endpoint to confirm the ledger matched byte for byte. Input tokens are exact (bytes / 4). Output tokens are reported at the sample median and p90 for the default structured contract; the sample date and size are shown next to the calculator, and the manifest (source URL and licence per file), raw records, and write-up are published in the repository under docs/.

  • STEP and IGES output is a small, stable fraction of input — cost tracks file size closely
  • PDF, DXF, and SVG output varies several-fold with drawing content — treat the p90 as the planning number
  • The both contract appends a point cloud whose size does not track file size, so it is not estimated

Response fields

Returned on every successful response.

idstring

Unique response id.

objectstring

The object type. Usually response.

modelstring

The model that generated the response.

outputarray

Typed spatial outputs for the requested task. When the request carried a cad_scene, understand, describe, and compare add output[].data.cad_scene: named objects with absolute bounds and parents, connectors with direction, spatial relations, title block, and callout counts; compare adds output[].data.cad_scene_diff (added, removed, moved, re-parented, rewired, dimensions changed).

usageobject

Input spatial tokens, output spatial tokens, projected input cost, projected output cost, and total estimated cost.

request_idstring

Request id for support and debugging.