latestOpenAPI 3.1.02026-08-0894186.0 KB

f1cfb00607df

v1

(ESM3) Generates an output track conditioned on inputs

post/api/v1/generate

Request body

model'esm3-open-2024-03' required

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.

trackstring required

Track to generate: sequence, structure, secondary_structure, sasa, or function.

invalid_idsinteger[]

Token indices that should not be sampled.

schedule'cosine' | 'linear'

Unmasking schedule for generation. Controls the number of tokens to unmask during each round of iterative generation.

strategy'random' | 'entropy'

Unmasking strategy to use. Controls which tokens to unmask during each round of iterative generation. 'random' will unmask a correct number of tokens randomly. 'entropy' will unmask the tokens with the lowest logit entropy first. Default was random. Updated on 02/14/2025.

num_stepsinteger

Number of steps for generation. There is diminishing return for decoding steps more than 20. Note that this needs to be less than or equal to the sequence length. Default was 8. Updated on 02/14/2025.

temperaturenumber

Temperature for sampling. Default was 1.0. Updated on 02/14/2025.

temperature_annealingboolean

Whether temperature should be annealed during generation. Default was False. Updated on 02/14/2025.

top_pnumber

Top-p sampling.

condition_on_coordinates_onlyboolean

Use coordinates instead of structure tokens as generation conditioning.

only_compute_backbone_rmsdboolean

Only compute the RMSD of the backbone atoms. Affects the returned crmsd.

Response

Successful Response

model'esm3-open-2024-03' 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.