latestOpenAPI 3.1.02026-08-0894186.0 KB

f1cfb00607df

v1

(ESM3, ESMFold2) Folds proteins. Defaults to esmfold2-fast-2026-05 if no model is given

post/api/v1/fold

Request body

model'esm3-open-2024-03' | 'esmfold2-fast-2026-05' | 'esmfold2-2026-05' | 'null' nullable

You may have access to additional, private models as well. These will be visible on the Rate Limits page under the Developer Console

potential_sequence_of_concernboolean

Disclose potential sequences of concern. For approved users, such sequences will not go through additional safety filtering. Reach out if you are interested in using this.

sequencestring nullable

Input sequence to be folded.

num_loopsinteger

(ESMFold2) Number of trunk loops for iterative refinement.

num_sampling_stepsinteger

(ESMFold2) Diffusion ODE solver steps. Lower for speed, higher for quality.

lm_dropoutnumber

(ESMFold2) Dropout probability on LM pair embeddings. When > 0, dropout is applied.

lm_mask_pctnumber

(ESMFold2) Fraction of sequence residues randomly masked before the PLM backbone. If not provided, defaults to 0.1 for ESMFOLD2_FAST and 0.0 for ESMFOLD2

msa_max_depthinteger nullable

(ESMFold2) Number of MSA rows randomly subsampled each loop. Set to null to disable (sets msa_subsample_at_inference to False).

msa_column_mask_ratenumber

(ESMFold2) Fraction of MSA columns randomly masked in non-query rows for inference-time diversity.

include_distogramboolean

(ESMFold2) Whether to include distogram predictions in the response.

include_paeboolean

(ESMFold2) Whether to include Predicted Aligned Error (PAE) matrix in the response.

include_pair_chains_iptmboolean

(ESMFold2) Whether to include pair-chain IPTM predictions in the response.

include_embeddingsboolean

(ESMFold2) Whether to include sequence and pair embeddings in the response.

Response

Successful Response

model'esm3-open-2024-03' | 'esmfold2-fast-2026-05' | 'esmfold2-2026-05' required

You may have access to additional, private models as well. These will be visible on the Rate Limits page under the Developer Console

createdstring required

ISO formatted date time

potential_sequence_of_concernboolean

Indicate that the returned sequence may be of potential concerns.

warning_messagesstring[] nullable

Warning messages returned by FastAPI.

complexobject nullable

Molecular complex with support for proteins, nucleic acids, and ligands.

plddtnumber[] nullable

Per position plddt predictions for a protein or molecular complex. Usually produced by structure decoder.

ptmnumber nullable

Predicted TM score of a protein or molecular complex. Usually produced by structure decoder.

interface_ptmnumber nullable

Interface TM score of a protein or molecular complex.

residue_indexinteger[] nullable

Residue indexes from the model. Only present if embeddings are requested.

entity_idinteger[] nullable

Entity ids (e.g. chain ids) from the model. Only present if embeddings are requested.