For Agents
Run NVIDIA-hosted models for weather forecasting, vision-language reasoning, image and video generation, biology, genomics, retrieval, and route optimisation through one bearer-authenticated API.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Earth-2 Inference Server, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Earth-2 Inference Server API.
Generate weather forecasts via /nvidia/ai-weather-forecasting and ensemble weather models
Run chat completions against hosted language models via /chat/completions
Generate images and video via /genai/stabilityai/sdxl-turbo, /genai/stabilityai/stable-diffusion-xl, and /genai/stabilityai/stable-video-diffusion
GET STARTED
Use for: Generate a 7-day weather forecast for a specific region, Predict the 3D structure of a protein from its amino acid sequence, Dock a candidate ligand against a target protein, Generate a high-resolution image from a text prompt with SDXL
Not supported: Does not handle GPU provisioning, model fine-tuning, or training jobs — use for hosted inference against NVIDIA-curated models on the Earth-2 server only.
Jentic publishes the only available OpenAPI specification for Earth-2 Inference Server, keeping it validated and agent-ready. NVIDIA's Earth-2 Inference Server hosts a portfolio of NVIDIA NIM and partner models behind a single API: weather forecasting, vision-language models, image and video generation, biology models including ESMFold and DiffDock, genomics pipelines, retrieval embeddings and reranking, chat completions, and the cuOpt optimisation engine. The 19 endpoints together let developers route a request to the right model and poll long-running jobs via /status/{requestId}.
Reason over images via vision-language models such as /vlm/microsoft/kosmos-2 and /vlm/nvidia/neva-22b
Predict protein structures via /biology/nvidia/esmfold and dock molecules via /biology/mit/diffdock
Run genomics pipelines via /genomics/nvidia/deepvariant and /genomics/nvidia/fq2bam
Compute retrieval embeddings and rerank results via /retrieval/nvidia/embeddings and /retrieval/nvidia/reranking, and solve routing problems via /nvidia/cuopt
Patterns agents use Earth-2 Inference Server API for, with concrete tasks.
★ Weather and Climate Forecasting
Generate medium-range and ensemble weather forecasts for a region by calling /nvidia/ai-weather-forecasting and the related forecast endpoints, which run NVIDIA's AI weather models on Earth-2 infrastructure. Agents can request a forecast, poll /status/{requestId} until the job is complete, and retrieve the predicted fields.
Submit a weather forecast request via /nvidia/ai-weather-forecasting for a specified bounding box and lead time, then poll /status/{requestId} until the predicted fields are available.
Drug Discovery and Protein Modelling
Combine /biology/nvidia/esmfold to predict a protein structure from sequence with /biology/mit/diffdock to dock candidate ligands and /biology/nvidia/molmim/generate to suggest novel candidates. The biology endpoints together support a structure-based screening workflow without local GPU infrastructure.
Predict a protein structure with /biology/nvidia/esmfold, then dock a SMILES ligand against the predicted PDB via /biology/mit/diffdock and rank the resulting poses.
Multimodal Generative Workflows
Run image, video, and language workflows from a single endpoint family — generate images with SDXL Turbo or Stable Diffusion XL, produce short clips with Stable Video Diffusion, and caption or reason over images with the VLM endpoints. The /chat/completions endpoint handles the language side so a single agent can orchestrate end-to-end multimodal pipelines.
Generate an image with /genai/stabilityai/stable-diffusion-xl, then caption it via /vlm/microsoft/kosmos-2 and feed the caption into /chat/completions for downstream summarisation.
Retrieval-Augmented Generation Backbone
Build the embedding and reranking backbone for a RAG application using /retrieval/nvidia/embeddings to vectorise documents and /retrieval/nvidia/reranking to rerank candidate passages against a user query. Combined with /chat/completions, this is a complete NVIDIA-hosted RAG stack.
Embed a corpus via /retrieval/nvidia/embeddings, retrieve top-K candidates from a vector store, rerank them via /retrieval/nvidia/reranking, then call /chat/completions to answer the user query.
AI Agent Multimodel Orchestration via Jentic
An AI agent that needs weather, vision, biology, or routing capability can search Jentic, find the matching Earth-2 endpoint, and execute it without holding the raw NVIDIA API key. Jentic vaults the bearer token and the agent only sees scoped execution.
Use the Jentic search query 'predict a protein structure' to find /biology/nvidia/esmfold and execute with the input amino acid sequence.
19 endpoints — jentic publishes the only available openapi specification for earth-2 inference server, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/chat/completions
Run chat completions against hosted language models
/nvidia/ai-weather-forecasting
Generate AI-driven weather forecast
/biology/nvidia/esmfold
Predict a protein structure from sequence
/biology/mit/diffdock
Dock a ligand against a protein structure
/genai/stabilityai/stable-diffusion-xl
Generate an image from a text prompt
/retrieval/nvidia/embeddings
Generate text embeddings
/retrieval/nvidia/reranking
Rerank candidate passages against a query
/status/{requestId}
Poll status of a long-running inference job
/chat/completions
Run chat completions against hosted language models
/nvidia/ai-weather-forecasting
Generate AI-driven weather forecast
/biology/nvidia/esmfold
Predict a protein structure from sequence
/biology/mit/diffdock
Dock a ligand against a protein structure
/genai/stabilityai/stable-diffusion-xl
Generate an image from a text prompt
Three things that make agents converge on Jentic-routed access.
Credential isolation
The NVIDIA Earth-2 Bearer token is stored encrypted in the Jentic vault. Agents receive scoped execution rights and never see the raw key.
Intent-based discovery
Agents search Jentic by intent such as 'predict a protein structure' or 'forecast the weather' and Jentic returns the matching Earth-2 endpoint with its input schema.
Time to first call
Direct Earth-2 integration: 1-2 days to wire up auth, async polling, and the right model endpoint per task. Through Jentic: under 1 hour.
Alternatives and complements available in the Jentic catalogue.
Specific to using Earth-2 Inference Server API through Jentic.
Why is there no official OpenAPI spec for Earth-2 Inference Server?
NVIDIA does not publish a single consolidated OpenAPI specification for the Earth-2 Inference Server portfolio. Jentic generates and maintains this spec so that AI agents and developers can call Earth-2 Inference Server via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Earth-2 Inference Server use?
The API uses a Bearer token in the Authorization header obtained from NVIDIA. Through Jentic the bearer token is stored encrypted in the vault and the agent receives a scoped execution context only.
Can I run protein structure prediction with this API?
Yes. POST a sequence to /biology/nvidia/esmfold to receive the predicted structure, and chain into /biology/mit/diffdock for ligand docking on the predicted PDB.
How do long-running inference jobs work?
Submit the inference request to the relevant model endpoint, then poll GET /status/{requestId} with the returned request ID until the result is ready. This pattern applies to weather, biology, and other heavyweight models.
How do I generate an image through Jentic?
Search Jentic for 'generate an image', load the schema for /genai/stabilityai/stable-diffusion-xl, and execute with the prompt. The Python SDK uses await client.search, await client.load, await client.execute.
Which retrieval endpoints power a RAG stack?
Use /retrieval/nvidia/embeddings to vectorise text and /retrieval/nvidia/reranking to rerank candidate passages against a query. Combined with /chat/completions you have a complete NVIDIA-hosted RAG flow.
/retrieval/nvidia/embeddings
Generate text embeddings
/retrieval/nvidia/reranking
Rerank candidate passages against a query
/status/{requestId}
Poll status of a long-running inference job