Estimate cost for a protein sequence redesign run

client.Protein.SequenceRedesign.EstimateCost(ctx, body) (*ProteinSequenceRedesignEstimateCostResponse, error)

POST/compute/v1/protein/sequence-redesign/estimate-cost

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

ParametersExpand Collapse

body ProteinSequenceRedesignEstimateCostParams

Entities param.Field[[]ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityUnion]

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

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity

ChainID string

minLength1

Role Target

Type FromTemplate

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntity

ChainID string

minLength1

Role Binder

Type FromTemplate

DesignMotifs []ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifOptional

Residues to redesign. Omit this field to keep the binder chain fixed.

Filters []ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterUnion

Filters applied to this motif in addition to global_design_filters.

One of the following:

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterExcludedAminoAcidsDesignFilter

AminoAcids []string

Single-letter amino-acid codes that must not occur in the filtered designed region.

Type ExcludedAminoAcids

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterMaxHydrophobicFractionDesignFilter

MaxFraction float64

minimum0

maximum1

Type MaxHydrophobicFraction

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignBinderEntityDesignMotifFilterExcludedSequenceMotifsDesignFilter

Motifs []string

Sequence motifs that must not occur. X matches any single residue.

Type ExcludedSequenceMotifs

Residues []int64

0-indexed residues to redesign on this chain.

Type Residues

NumProteins param.Field[int64]

Number of unique filter-passing redesigned proteins to generate.

minimum1

maximum1000

Structure param.Field[ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputStructureUnion]

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

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputStructureURLSource

Type URL

URL string

formaturi

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputStructureCifBase64Source

Data string

Base64-encoded CIF file contents

MediaType ChemicalXCif

Must be chemical/x-cif for CIF files

Type Base64

Type param.Field[Binder]

const BinderBinder Binder = "binder"

GlobalDesignFilters param.Field[[]ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterUnion]Optional

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

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterExcludedAminoAcidsDesignFilter

AminoAcids []string

Single-letter amino-acid codes that must not occur in the filtered designed region.

Type ExcludedAminoAcids

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterMaxHydrophobicFractionDesignFilter

MaxFraction float64

minimum0

maximum1

Type MaxHydrophobicFraction

ProteinSequenceRedesignEstimateCostParamsBinderProteinSequenceRedesignRunInputGlobalDesignFilterExcludedSequenceMotifsDesignFilter

Motifs []string

Sequence motifs that must not occur. X matches any single residue.

Type ExcludedSequenceMotifs

IdempotencyKey param.Field[string]Optional

maxLength255

WorkspaceID param.Field[string]Optional

Workspace to run this redesign in.

ReturnsExpand Collapse

type ProteinSequenceRedesignEstimateCostResponse struct{…}

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

Breakdown ProteinSequenceRedesignEstimateCostResponseBreakdown

Cost breakdown for the billed application.

Application ProteinSequenceRedesignEstimateCostResponseBreakdownApplication

One of the following:

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationStructureAndBinding ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "structure_and_binding"

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationSmallMoleculeDesign ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "small_molecule_design"

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationSmallMoleculeLibraryScreen ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "small_molecule_library_screen"

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationProteinDesign ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "protein_design"

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationProteinRedesign ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "protein_redesign"

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationProteinLibraryScreen ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "protein_library_screen"

const ProteinSequenceRedesignEstimateCostResponseBreakdownApplicationAdme ProteinSequenceRedesignEstimateCostResponseBreakdownApplication = "adme"

CostPerUnitUsd 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.

NumUnits int64

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

EstimatedCostUsd string

Estimated total cost as a decimal string

Estimate cost for a protein sequence redesign run

package main

import (
  "context"
  "fmt"

  "github.com/boltz-bio/boltz-api-go"
  "github.com/boltz-bio/boltz-api-go/option"
)

func main() {
  client := boltzapi.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.Protein.SequenceRedesign.EstimateCost(context.TODO(), boltzapi.ProteinSequenceRedesignEstimateCostParams{
    OfBinderProteinSequenceRedesignRunInput: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInput{
      Entities: []boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{
        OfProteinSequenceRedesignEstimateCostsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity{
          ChainID: "x",
        },
      }, boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityUnion{
        OfProteinSequenceRedesignEstimateCostsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputEntityBinderSequenceRedesignTargetEntity{
          ChainID: "x",
        },
      }},
      NumProteins: 1,
      Structure: boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputStructureUnion{
        OfProteinSequenceRedesignEstimateCostsBodyBinderProteinSequenceRedesignRunInputStructureURLSource: &boltzapi.ProteinSequenceRedesignEstimateCostParamsBodyBinderProteinSequenceRedesignRunInputStructureURLSource{
          URL: "https://example.com",
        },
      },
    },
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Breakdown)
}

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