Start a structure and binding prediction
POST/compute/v1/predictions/structure-and-binding
Submit a prediction job that produces 3D structure coordinates and confidence scores for the input molecular complex, with optional binding metrics.
Body Parameters
model: "boltz-2.1"
Model to use for prediction
idempotency_key: optional string
Client-provided key to prevent duplicate submissions on retries
maxLength255
workspace_id: optional string
Target workspace ID (admin keys only; ignored for workspace keys)
Returns
id: string
Unique prediction identifier
completed_at: string
formatdate-time
created_at: string
formatdate-time
data_deleted_at: string
When the input/output data was deleted, or null if still available
formatdate-time
expires_at: string
When this resource and its associated data will be permanently deleted. Null while still in progress.
formatdate-time
livemode: boolean
Whether this resource was created with a live API key.
model: "boltz-2.1"
Model used for prediction
started_at: string
formatdate-time
version: string
Model version used for prediction
workspace_id: string
Workspace ID
idempotency_key: optional string
Client-provided idempotency key
Start a structure and binding prediction
curl https://api.boltz.bio/compute/v1/predictions/structure-and-binding \
-H 'Content-Type: application/json' \
-H "x-api-key: $BOLTZ_API_KEY" \
-d '{
"input": {
"entities": [
{
"chain_ids": [
"string"
],
"type": "protein",
"value": "value"
}
]
},
"model": "boltz-2.1"
}'{
"id": "sab_pred_2X7Ab9Cd3Ef6Gh1JkLmN",
"completed_at": "2019-12-27T18:11:19.117Z",
"created_at": "2019-12-27T18:11:19.117Z",
"data_deleted_at": "2019-12-27T18:11:19.117Z",
"error": {
"code": "code",
"message": "message",
"details": {}
},
"expires_at": "2019-12-27T18:11:19.117Z",
"input": {
"entities": [
{
"chain_ids": [
"string"
],
"type": "protein",
"value": "value",
"cyclic": true,
"modifications": [
{
"residue_index": 0,
"type": "ccd",
"value": "value"
}
]
}
],
"binding": {
"binder_chain_id": "binder_chain_id",
"type": "ligand_protein_binding"
},
"bonds": [
{
"atom1": {
"atom_name": "atom_name",
"chain_id": "chain_id",
"type": "ligand_atom"
},
"atom2": {
"atom_name": "atom_name",
"chain_id": "chain_id",
"type": "ligand_atom"
}
}
],
"constraints": [
{
"binder_chain_id": "binder_chain_id",
"contact_residues": {
"A": [
42,
43,
44,
67,
68,
69
]
},
"max_distance_angstrom": 0,
"type": "pocket",
"force": true
}
],
"model_options": {
"recycling_steps": 1,
"sampling_steps": 1,
"step_scale": 1.3
},
"num_samples": 1
},
"livemode": true,
"model": "boltz-2.1",
"output": {
"all_sample_results": [
{
"metrics": {
"complex_ipde": 0,
"complex_iplddt": 0,
"complex_pde": 0,
"complex_plddt": 0,
"iptm": 0,
"ligand_iptm": 0,
"protein_iptm": 0,
"ptm": 0,
"structure_confidence": 0
},
"structure": {
"url": "https://example.com",
"url_expires_at": "2019-12-27T18:11:19.117Z"
}
}
],
"best_sample": {
"metrics": {
"complex_ipde": 0,
"complex_iplddt": 0,
"complex_pde": 0,
"complex_plddt": 0,
"iptm": 0,
"ligand_iptm": 0,
"protein_iptm": 0,
"ptm": 0,
"structure_confidence": 0
},
"structure": {
"url": "https://example.com",
"url_expires_at": "2019-12-27T18:11:19.117Z"
}
},
"archive": {
"url": "https://example.com",
"url_expires_at": "2019-12-27T18:11:19.117Z"
},
"binding_metrics": {
"binding_confidence": 0,
"optimization_score": 0,
"type": "ligand_protein_binding_metrics"
}
},
"started_at": "2019-12-27T18:11:19.117Z",
"status": "pending",
"version": "version",
"workspace_id": "workspace_id",
"idempotency_key": "idempotency_key"
}Returns Examples
{
"id": "sab_pred_2X7Ab9Cd3Ef6Gh1JkLmN",
"completed_at": "2019-12-27T18:11:19.117Z",
"created_at": "2019-12-27T18:11:19.117Z",
"data_deleted_at": "2019-12-27T18:11:19.117Z",
"error": {
"code": "code",
"message": "message",
"details": {}
},
"expires_at": "2019-12-27T18:11:19.117Z",
"input": {
"entities": [
{
"chain_ids": [
"string"
],
"type": "protein",
"value": "value",
"cyclic": true,
"modifications": [
{
"residue_index": 0,
"type": "ccd",
"value": "value"
}
]
}
],
"binding": {
"binder_chain_id": "binder_chain_id",
"type": "ligand_protein_binding"
},
"bonds": [
{
"atom1": {
"atom_name": "atom_name",
"chain_id": "chain_id",
"type": "ligand_atom"
},
"atom2": {
"atom_name": "atom_name",
"chain_id": "chain_id",
"type": "ligand_atom"
}
}
],
"constraints": [
{
"binder_chain_id": "binder_chain_id",
"contact_residues": {
"A": [
42,
43,
44,
67,
68,
69
]
},
"max_distance_angstrom": 0,
"type": "pocket",
"force": true
}
],
"model_options": {
"recycling_steps": 1,
"sampling_steps": 1,
"step_scale": 1.3
},
"num_samples": 1
},
"livemode": true,
"model": "boltz-2.1",
"output": {
"all_sample_results": [
{
"metrics": {
"complex_ipde": 0,
"complex_iplddt": 0,
"complex_pde": 0,
"complex_plddt": 0,
"iptm": 0,
"ligand_iptm": 0,
"protein_iptm": 0,
"ptm": 0,
"structure_confidence": 0
},
"structure": {
"url": "https://example.com",
"url_expires_at": "2019-12-27T18:11:19.117Z"
}
}
],
"best_sample": {
"metrics": {
"complex_ipde": 0,
"complex_iplddt": 0,
"complex_pde": 0,
"complex_plddt": 0,
"iptm": 0,
"ligand_iptm": 0,
"protein_iptm": 0,
"ptm": 0,
"structure_confidence": 0
},
"structure": {
"url": "https://example.com",
"url_expires_at": "2019-12-27T18:11:19.117Z"
}
},
"archive": {
"url": "https://example.com",
"url_expires_at": "2019-12-27T18:11:19.117Z"
},
"binding_metrics": {
"binding_confidence": 0,
"optimization_score": 0,
"type": "ligand_protein_binding_metrics"
}
},
"started_at": "2019-12-27T18:11:19.117Z",
"status": "pending",
"version": "version",
"workspace_id": "workspace_id",
"idempotency_key": "idempotency_key"
}