Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

EvolutionaryScale Sampling API

Low-level forward passes with logits and sampling control.

EvolutionaryScale Sampling API is one of 7 APIs that EvolutionaryScale publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Sampling. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 12 schemas. It is described by OpenAPI 3.1.0, at version 2024-08-01.

Requests are made against a single base URL, https://forge.evolutionaryscale.ai.

3 operations 3 paths 12 schemas 3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2024-08-01
Server
https://forge.evolutionaryscale.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

EvolutionaryScale Sampling API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Forge API token issued via forge.evolutionaryscale.ai.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 POST. Each is listed below with its method, path, parameters, and response codes.

Sampling 3

Low-level forward passes with logits and sampling control.

POST
/api/v1/forward_and_sample
Forward And Sample
forwardAndSample body → 2004XX
POST
/api/v1/logits
Get Logits And Embeddings
logits body → 2004XX
POST
/api/v1/esmc/logits
Get ESM C Logits And Embeddings
esmcLogits body → 2004XX

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are ESMProteinTensor (6 properties), SamplingConfig (5 properties), ForwardAndSampleOutput (4 properties), LogitsConfig (4 properties). Each schema is shown below with its type and property counts.

ForwardAndSampleOutput
object
4 properties
ESMCLogitsRequest
object
3 properties 2 required
Error
object
1 property
SamplingConfig
object
Per-track sampling configuration for forwardandsample.
5 properties
LogitsConfig
object
4 properties
LogitsOutput
object
Logits, embeddings, and optional hidden states.
3 properties
SamplingTrackConfig
object
4 properties
ESMProteinTensor_2
object
1 property
ForwardAndSampleRequest
object
3 properties 3 required
ESMProteinTensor
object
Tokenized representation of a protein across all ESM3 tracks.
6 properties
LogitsRequest
object
3 properties 2 required
LogitsOutput_2
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

evolutionaryscale-sampling-api-openapi.yml Raw ↑

Other APIs EvolutionaryScale publishes across the network.

EvolutionaryScale ESM Python SDK
EvolutionaryScale Embeddings API
EvolutionaryScale Encoding API
EvolutionaryScale Generation API
EvolutionaryScale MSA API
EvolutionaryScale Structure API