## Estimate cost for a protein sequence redesign run

`$ boltz-api protein:sequence-redesign estimate-cost`

**post** `/compute/v1/protein/sequence-redesign/estimate-cost`

Estimate the cost of a protein sequence redesign run without creating any resource or consuming GPU.

### Parameters

- `--entity: array of object { chain_id, role, type }  or object { chain_id, role, type, design_motifs }`

  Every chain in the input CIF, assigned exactly once as target or binder.

- `--num-proteins: number`

  Number of unique filter-passing redesigned proteins to generate.

- `--structure: object { type, url }  or object { data, media_type, type }`

  How to provide a CIF structure file. URLs are auto-detected; base64 uploads must use chemical/x-cif media type.

- `--type: "binder"`

- `--global-design-filter: optional array of object { amino_acids, type }  or object { max_fraction, type }  or object { motifs, type }`

  Filters applied to every redesigned region. When omitted, cysteine is excluded. Pass [] to disable global filters.

- `--idempotency-key: optional string`

- `--workspace-id: optional string`

  Workspace to run this redesign in.

### Returns

- `ProteinSequenceRedesignEstimateCostResponse: 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

### Example

```cli
boltz-api protein:sequence-redesign estimate-cost \
  --api-key 'My API Key' \
  --entity '{chain_id: x, role: target, type: from_template}' \
  --entity '{chain_id: x, role: target, type: from_template}' \
  --num-proteins 1 \
  --structure '{type: url, url: https://example.com}' \
  --type binder
```

#### Response

```json
{
  "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"
}
```