Models Hub Route Reference

Active public Models Hub launch routes on the Om API `/v2/hub/*` surface.

All active Hub launch routes are asynchronous `POST` endpoints. They return an accepted response with `job_id` and `status`, require `x-api-key`, and support `Idempotency-Key` so you can retry safely. Routes that start from uploaded structures use `artifact_id` values from `/v2/artifacts/upload`.

Active Public Model Routes

ModelRoutePrimary InputsInput Style
Boltz2/v2/hub/boltz2/startprotein_sequence plus optional ligand or nucleic-acid contextSequence
BoltzGen/v2/hub/boltzgen/startprotocol plus protocol-specific target CIF artifact or ligand SMILESMixed
RosettaFold3/v2/hub/rosettafold3/startprotein_sequenceSequence
Chai1/v2/hub/chai1/startprotein_sequence plus optional ligand or nucleic-acid contextSequence
RFD3/v2/hub/rfd3/startpdb_artifact_id, design_mode, contigArtifact
BindCraft/v2/hub/bindcraft/starttarget_pdb_artifact_id plus optional target context fieldsArtifact
AlphaFold/v2/hub/alphafold/startprotein_sequence plus optional multimer selectorSequence
ProteinTTT/v2/hub/proteinttt/startsequenceSequence
DiffDock/v2/hub/diffdock/startprotein_artifact_id, ligand_smilesArtifact
FlowDock/v2/hub/flowdock/startprotein_artifact_id, ligand_smilesArtifact
NeuralPLexer/v2/hub/neuralplexer/startprotein_sequence, ligand_smiles, optional protein_sequences_additionalSequence
OpenFold3/v2/hub/openfold3/startprotein_sequence plus optional ligand or nucleic-acid contextSequence
POST/v2/hub/boltz2/start

Boltz2

Launch the active Boltz2 workflow with a primary protein sequence and optional ligand or nucleic-acid context.

cURL
curl -X POST https://api.omtx.ai/v2/hub/boltz2/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: boltz2-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG",
    "ligand_smiles": "CCO"
  }'
Response
{
  "job_id": "job_boltz2_123",
  "status": "queued"
}
POST/v2/hub/boltzgen/start

BoltzGen

Launch the active BoltzGen workflow with the required `protocol` field and optional uploaded target structure context.

cURL
curl -X POST https://api.omtx.ai/v2/hub/boltzgen/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: boltzgen-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protocol": "protein_anything",
    "target_cif_artifact_id": "11111111-1111-1111-1111-111111111111",
    "target_chain_id": "A",
    "binder_length_min": 60,
    "binder_length_max": 90
  }'
Response
{
  "job_id": "job_boltzgen_123",
  "status": "queued"
}
POST/v2/hub/rosettafold3/start

RosettaFold3

Launch RosettaFold3 with a single protein sequence.

cURL
curl -X POST https://api.omtx.ai/v2/hub/rosettafold3/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: rf3-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG"
  }'
Response
{
  "job_id": "job_rosettafold3_123",
  "status": "queued"
}
POST/v2/hub/chai1/start

Chai1

Launch Chai1 with a primary protein sequence and optional ligand or nucleic-acid context.

cURL
curl -X POST https://api.omtx.ai/v2/hub/chai1/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: chai1-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG",
    "ligand_smiles": "CCO"
  }'
Response
{
  "job_id": "job_chai1_123",
  "status": "queued"
}
POST/v2/hub/rfd3/start

RFD3

Launch RFD3 from an uploaded structure, a design mode, and a contig string.

cURL
curl -X POST https://api.omtx.ai/v2/hub/rfd3/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: rfd3-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "pdb_artifact_id": "11111111-1111-1111-1111-111111111111",
    "design_mode": "ppi_binder",
    "contig": "A1-120/0 60-80",
    "hotspot_selection": "E64:CD2,CZ;E88:CG,CZ"
  }'
Response
{
  "job_id": "job_rfd3_123",
  "status": "queued"
}
  • `ppi_binder` requires `hotspot_selection`.
  • `small_molecule_binder` requires `ligand` instead.
POST/v2/hub/bindcraft/start

BindCraft

Launch BindCraft against an uploaded target structure artifact.

cURL
curl -X POST https://api.omtx.ai/v2/hub/bindcraft/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: bindcraft-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "target_pdb_artifact_id": "11111111-1111-1111-1111-111111111111",
    "target_chains": "A",
    "target_name": "p53_target",
    "hotspot_residues": "A94,A95,A96"
  }'
Response
{
  "job_id": "job_bindcraft_123",
  "status": "queued"
}
  • BindCraft runs with a fixed profile. Do not send settings such as `design_protocol` or `mpnn_model`.
POST/v2/hub/alphafold/start

AlphaFold

Launch AlphaFold with a primary protein sequence and optional multimer selector.

cURL
curl -X POST https://api.omtx.ai/v2/hub/alphafold/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: alphafold-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG",
    "model_type": "auto"
  }'
Response
{
  "job_id": "job_alphafold_123",
  "status": "queued"
}
POST/v2/hub/proteinttt/start

ProteinTTT

Launch ProteinTTT with a single sequence.

cURL
curl -X POST https://api.omtx.ai/v2/hub/proteinttt/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: proteinttt-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG"
  }'
Response
{
  "job_id": "job_proteinttt_123",
  "status": "queued"
}
POST/v2/hub/diffdock/start

DiffDock

Launch DiffDock docking from an uploaded protein artifact and ligand SMILES string.

cURL
curl -X POST https://api.omtx.ai/v2/hub/diffdock/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: diffdock-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_artifact_id": "11111111-1111-1111-1111-111111111111",
    "ligand_smiles": "CCO"
  }'
Response
{
  "job_id": "job_diffdock_123",
  "status": "queued"
}
POST/v2/hub/flowdock/start

FlowDock

Launch FlowDock docking from an uploaded protein artifact and ligand SMILES string.

cURL
curl -X POST https://api.omtx.ai/v2/hub/flowdock/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: flowdock-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_artifact_id": "11111111-1111-1111-1111-111111111111",
    "ligand_smiles": "CCO"
  }'
Response
{
  "job_id": "job_flowdock_123",
  "status": "queued"
}
POST/v2/hub/neuralplexer/start

NeuralPLexer

Launch NeuralPLexer with a primary protein sequence and ligand SMILES string.

cURL
curl -X POST https://api.omtx.ai/v2/hub/neuralplexer/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: neuralplexer-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG",
    "ligand_smiles": "CCO"
  }'
Response
{
  "job_id": "job_neuralplexer_123",
  "status": "queued"
}
POST/v2/hub/openfold3/start

OpenFold3

Launch OpenFold3 with a primary protein sequence and optional ligand or nucleic-acid context.

cURL
curl -X POST https://api.omtx.ai/v2/hub/openfold3/start \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: openfold3-demo-001" \
  -H "Content-Type: application/json" \
  -d '{
    "protein_sequence": "MSTNPKPQRKTKRNTNRRPQDVKFPGG",
    "ligand_smiles": "CCO"
  }'
Response
{
  "job_id": "job_openfold3_123",
  "status": "queued"
}