For Agents
Generate chat completions with DeepSeek language models using an OpenAI-compatible request format, list available models, and check account balance.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the DeepSeek API, 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 DeepSeek API.
Generate chat completions from prompts using DeepSeek models via POST /chat/completions
List the DeepSeek models available to the calling account through GET /models
Check remaining account balance and granted credit with GET /user/balance
GET STARTED
Use for: I want to generate a chat completion with a DeepSeek model, List all DeepSeek models available to my account, Check the remaining balance on my DeepSeek account, Get the response from DeepSeek for a multi-turn conversation
Not supported: Does not handle image generation, audio transcription, fine-tuning, or embeddings — use for DeepSeek chat completions and account state only.
Jentic publishes the only available OpenAPI specification for DeepSeek API, keeping it validated and agent-ready. DeepSeek provides access to its family of large language models through an OpenAI-compatible chat completions interface, making it straightforward to swap into existing tooling. The API exposes chat completions, model listings, and account balance lookups so agents can generate responses, choose between available DeepSeek models, and monitor remaining credit. Authentication uses Bearer tokens and the surface is intentionally small, with three endpoints covering inference and account state.
Stream multi-turn assistant responses by reusing the OpenAI-compatible message format
Select between DeepSeek model variants when issuing a chat completion request
Patterns agents use DeepSeek API for, with concrete tasks.
★ OpenAI-Compatible Chat Completions
Drop DeepSeek into an existing OpenAI-compatible client by pointing the base URL at api.deepseek.com and supplying a Bearer token. The /chat/completions endpoint accepts the same message and parameter shape, allowing teams to evaluate DeepSeek outputs against other providers without rewriting their inference layer. This is the fastest way to A/B test model quality and pricing.
Send a chat completion request to /chat/completions with a system prompt and user message, then return the assistant content.
Model Selection and Discovery
Before issuing a chat completion, an agent or developer can call /models to see which DeepSeek model identifiers the account has access to. This avoids hard-coded model names that drift over time and lets agents pick the most appropriate model at runtime. The list is small and stable, suitable for caching for short windows.
Call GET /models, parse the returned model list, and select the first chat-capable model id for the next completion.
Account Balance Monitoring
DeepSeek exposes /user/balance so applications can check remaining credit before issuing expensive completions. This lets agents and dashboards flag low balances, pause non-essential calls, or trigger top-ups. The endpoint returns granted, topped-up, and total balance figures suitable for billing alerts.
Call GET /user/balance and emit a warning if the total balance falls below a configured threshold.
AI Agent Integration via Jentic
Through Jentic, an agent finds DeepSeek by searching for an inference intent rather than reading docs. Jentic returns the matching operation schema for /chat/completions, the agent fills in the messages, and the call executes with the API key resolved from the Jentic vault. Swapping providers becomes a search query change, not a rewrite.
Use Jentic to search for 'generate text with DeepSeek', load the chat completions schema, and execute a request with a user prompt.
3 endpoints — jentic publishes the only available openapi specification for deepseek api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/chat/completions
Create a chat completion
/models
List available DeepSeek models
/user/balance
Get remaining account balance
/chat/completions
Create a chat completion
/models
List available DeepSeek models
/user/balance
Get remaining account balance
Three things that make agents converge on Jentic-routed access.
Credential isolation
DeepSeek Bearer API keys are stored encrypted in the Jentic vault. Agents receive scoped execution contexts and never see the raw key in their prompt or memory.
Intent-based discovery
Agents search by intent (e.g. 'generate a chat completion') and Jentic returns the DeepSeek /chat/completions operation with its full input schema, so the agent can call the right endpoint without reading docs.
Time to first call
Direct DeepSeek integration: a few hours to wire auth, retries, and balance checks. Through Jentic: under 15 minutes from search to first executed completion.
Alternatives and complements available in the Jentic catalogue.
Specific to using DeepSeek API through Jentic.
Why is there no official OpenAPI spec for DeepSeek API?
DeepSeek does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call DeepSeek API 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 DeepSeek API use?
The DeepSeek API uses HTTP Bearer token authentication. Pass your DeepSeek API key in the Authorization header as `Authorization: Bearer <key>`. Through Jentic, the key is stored in the encrypted vault and never enters the agent's context window.
Can I use the DeepSeek API as a drop-in for OpenAI?
Yes. The /chat/completions endpoint accepts the same messages array and parameters as the OpenAI chat completions API, so most OpenAI client libraries work by changing the base URL to https://api.deepseek.com and supplying a DeepSeek Bearer key.
How do I list the DeepSeek models my account can use?
Call GET /models with your Bearer token. The response contains the DeepSeek model identifiers available for chat completion requests, which you then pass as the `model` field on POST /chat/completions.
How do I check my remaining DeepSeek balance?
Call GET /user/balance. The endpoint returns granted credit, topped-up credit, and total remaining balance, which agents can use to gate expensive inference calls.
How do I generate a DeepSeek chat completion through Jentic?
Run `pip install jentic`, then search for 'generate text with DeepSeek', load the /chat/completions operation, and execute with your messages payload. Jentic resolves the Bearer token from the vault at execution time.