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 Encoding API

Tokenize ESMProtein objects into ESMProteinTensor inputs (and back).

EvolutionaryScale Encoding 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 Encoding. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 5 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.

2 operations 2 paths 5 schemas 2 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 Encoding 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 2

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

Encoding 2

Tokenize ESMProtein objects into ESMProteinTensor inputs (and back).

POST
/api/v1/encode
Encode Protein To Tensor
encode body → 2004XX
POST
/api/v1/decode
Decode Protein Tensor
decode body → 2004XX

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are ESMProtein (7 properties), ESMProteinTensor (6 properties), EncodeRequest (2 properties), DecodeRequest (2 properties). Each schema is shown below with its type and property counts.

DecodeRequest
object
2 properties 2 required
Error
object
1 property
EncodeRequest
object
2 properties 2 required
ESMProtein
object
Raw protein representation with optional sequence, structure, function, secondary structure, and SASA tracks.
7 properties
ESMProteinTensor
object
Tokenized representation of a protein across all ESM3 tracks.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

evolutionaryscale-encoding-api-openapi.yml Raw ↑

Other APIs EvolutionaryScale publishes across the network.

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