Skip to main content
After you deploy an NVIDIA NIM microservice as an application in Standalone Applications, you can start using it for your inference tasks. The only credentials that you need are the username and password that you provided when creating the application. You do not need a personal API key for NVIDIA NGC, the cloud platform from NVIDIA.

​
Getting the endpoint of a microservice

  1. In the web console, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/applications.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=06329add2f560a2a83d6c136ca5dfc9b Applications.
  2. Under Standalone applications, find your application and click See details.
  3. Under Artifacts, copy the URL from Public endpoint.

​
Supported requests

To send requests to any NVIDIA NIM microservice deployed as an application, use URLs of the following format: 
https://<username>:<password>@<endpoint><path>
  • <username>, <password>: The credentials that you provided when creating the application.
  • <endpoint>: The microservice’s endpoint; for example, public-e00-***.gw.msp.eu-north1.nebius.cloud.
  • <path>: The path to the API resource; for example, /v1/health/ready.
For paths supported by different NVIDIA NIM microservices, and request examples, see the following sections.

​
Health checks

You can run a health check on any NVIDIA NIM microservice by sending a GET /v1/health/ready request. For example, if your microservice’s endpoint is public-e00-***.gw.msp.eu-north1.nebius.cloud and you specified alice and MyPass_w0rd as your credentials when creating the application, run the following command to perform a health check: 
curl -X GET https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/v1/health/ready
If a health check is unsuccessful, restart the application or contact support.

​
Boltz-2: predicting protein structures

The Boltz-2 microservice accepts POST /biology/mit/boltz2/predict requests to predict protein structures from a list of polymers and optional lists of ligands and constraints. Example of a curl command: 
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/biology/mit/boltz2/predict

JSON='{
  "polymers": [
    {
      "id": "A",
      "molecule_type": "protein",
      "sequence": "MALWMRLLPLLALLALWGPDPAAAFVNQHLCGSHLVEALYLVCGERGFFYTPKTRREAEDLQVGQVELGGGPGAGSLQPLALEGSLQKRGIVEQCCTSICSLYQLENYCN"
    }
  ],
  "recycling_steps": 3,
  "sampling_steps": 50,
  "diffusion_samples": 1,
  "step_scale": 1.638,
  "output_format": "mmcif"
}'

curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/biology/mit/boltz2/predict
For more details and examples, see the API reference and the getting started guide in NVIDIA NIM for Boltz-2 documentation.

​
Evo 2: generating DNA sequences

The Evo 2 microservice accepts requests of the following types:
  • POST /biology/arc/evo2/generate to generate DNA sequences by predicting and appending nucleotides to the provided DNA sequences. Example of a curl command: 
    curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/biology/arc/evo2/generate

    JSON='{
  "sequence": "ACTGACTGACTGACTG",
  "num_tokens": 8,
  "top_k": 1,
  "enable_sampled_probs": true
}'

curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/biology/arc/evo2/generate
  • POST /biology/arc/evo2/forward to run forward passes of the Evo 2 model and save layer outputs.
For more details, see the API reference and the quickstart guide in NVIDIA NIM for Evo 2 documentation.

​
GenMol: generating molecules

The GenMol microservice accepts POST /generate requests to generate molecules from SMILES strings as molecular templates. Example of a curl command: 
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/generate

JSON='{
  "smiles": "[C@H]1O[C@@H](CO)[C@H](O)[C@@H]1O.[*{15-15}]",
  "num_molecules": "5",
  "temperature": "2.0",
  "noise": "1.0",
  "step_size": "1",
  "scoring": "QED"
}'

curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/generate
For more details and examples, see the API reference and the getting started guide in NVIDIA NIM for GenMol documentation.

​
MolMIM: generating molecules

The MolMIM microservice accepts requests of the following types:
  • POST /generate to generate molecules from SMILES strings as molecular templates. Example of a curl command: 
    curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/generate

    JSON='{
  "smi": "CN1C=NC2=C1C(=O)N(C(=O)N2C)C",
  "algorithm": "none",
  "num_molecules": 5,
  "particles": 8,
  "scaled_radius": 1.0
}'

curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "$JSON" \
  https://alice:MyPass_w0rd@public-e00-***.gw.msp.eu-north1.nebius.cloud/generate
  • POST /embedding to retrieve embeddings for given molecules.
  • POST /hidden to retrieve hidden states (latent codes) for given molecules.
  • POST /decode to decode hidden states into SMILES strings.
  • POST /sampling to sample hidden states from seed molecules.
For more details and examples, see the API reference and the quickstart guide in NVIDIA NIM for MolMIM documentation.