Estimate cost for a small molecule design run

$ boltz-api small-molecule:design estimate-cost

POST/compute/v1/small-molecule/design/estimate-cost

Estimate the billed cost of a small molecule design run without creating any resource or consuming GPU. Includes generation charges implied by the scheduler iteration cap plus structure-scoring charges for each requested molecule.

ParametersExpand Collapse

--num-molecules: number

Number of molecules to generate. Must be between 10 and 1,000,000.

--target: object { entities, bonds, constraints, 3 more }

Target protein sequences for small molecule design or screening.

--chemical-space: optional "enamine_real"

Chemical space to constrain generated molecules. Currently only ‘enamine_real’ (Enamine REAL chemical space) is supported. Additional options may be added in the future.

--idempotency-key: optional string

Client-provided key to prevent duplicate submissions on retries

--molecule-filters: optional object { boltz_smarts_catalog_filter_level, custom_filters }

Molecule filtering configuration. Controls both Boltz built-in SMARTS filtering and custom filters.

--workspace-id: optional string

Target workspace ID (admin keys only; ignored for workspace keys)

ReturnsExpand Collapse

SmallMoleculeDesignEstimateCostResponse: object { breakdown, disclaimer, estimated_cost_usd }

Estimate response with monetary values encoded as decimal strings to preserve precision.

breakdown: object { application, cost_per_unit_usd, num_units }

Cost breakdown for the billed application.

application: "structure_and_binding" or "small_molecule_design" or "small_molecule_library_screen" or 4 more

"structure_and_binding"

"small_molecule_design"

"small_molecule_library_screen"

"protein_design"

"protein_redesign"

"protein_library_screen"

"adme"

cost_per_unit_usd: string

Estimated cost per displayed unit as a decimal string, rounded up to 4 decimal places. This may include token-size multipliers or generation overhead; estimated_cost_usd is the authoritative total.

num_units: number

Number of billable units in the estimate. The unit depends on the endpoint: samples for structure-and-binding, molecules for ADME, and requested proteins or molecules for design/screen endpoints.

disclaimer: string

estimated_cost_usd: string

Estimated total cost as a decimal string

Estimate cost for a small molecule design run

boltz-api small-molecule:design estimate-cost \
  --api-key 'My API Key' \
  --num-molecules 10 \
  --target '{entities: [{chain_ids: [string], type: protein, value: value}]}'

{
  "breakdown": {
    "application": "structure_and_binding",
    "cost_per_unit_usd": "0.0500",
    "num_units": 1
  },
  "disclaimer": "This is an estimate only and may differ from your actual charges. Final billing is based on exact token counts computed at run time. For large library screens, the estimate is extrapolated from a sample and may be less accurate for highly variable inputs.",
  "estimated_cost_usd": "0.0500"
}

Returns Examples

{
  "breakdown": {
    "application": "structure_and_binding",
    "cost_per_unit_usd": "0.0500",
    "num_units": 1
  },
  "disclaimer": "This is an estimate only and may differ from your actual charges. Final billing is based on exact token counts computed at run time. For large library screens, the estimate is extrapolated from a sample and may be less accurate for highly variable inputs.",
  "estimated_cost_usd": "0.0500"
}