Adral API docs LAUNCHING SOON
Build with the Adral API
A step-by-step guide for startups in Adral for Startups: get your API key, send your first request, and call the Adral models from your own product.
Not open yet. The Adral API isn’t open to startup keys yet. You can do steps 1 to 3 today, and your key starts working the day the API opens.
1Before you start
To use the Adral API you need:
- An Adral account. It’s free, and it’s the same account you use everywhere in Adral.
- An approved application to Adral for Startups. API keys are for approved startups.
- A way to send HTTPS requests:
curlin a terminal, or JavaScript or Python in your app.
Not applied yet? It takes a few minutes and costs nothing.
2Get your API key
Your API key is how the Adral API knows a request comes from your startup.
- Sign in to your startup dashboard and open the API tab.
- Press Generate API key.
- Copy the key straight away and press I’ve saved my key.
Keys start with adral_live_. Each startup has one key at a time. The full key is
shown only once: Adral keeps just a fingerprint of it, so afterwards the
dashboard shows only its last four characters.
Lost your key? Press Regenerate on the API tab. You get a new key, and the old one stops working immediately.
3Store your key
Keep the key in an environment variable named ADRAL_API_KEY, not in your code.
The samples in this guide read it from there.
export ADRAL_API_KEY="adral_live_your_key_here"
$env:ADRAL_API_KEY = "adral_live_your_key_here"
This sets the key for the terminal you’re in. For a deployed app, put it in your hosting provider’s secrets or environment settings instead.
4Your first request
Send a POST to the chat completions endpoint with a JSON body that names the
model and the conversation as a list of messages. Each message has
a role and its content.
- Base URL
https://api.adral.ai/v1- Endpoint
POST /chat/completions- Authentication
Authorization: Bearer $ADRAL_API_KEY- Body
- JSON, with
Content-Type: application/json
curl https://api.adral.ai/v1/chat/completions \
-H "Authorization: Bearer $ADRAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "adral", "messages": [{"role": "user", "content": "Hello"}]}'
const response = await fetch("https://api.adral.ai/v1/chat/completions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.ADRAL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "adral",
messages: [{ role: "user", content: "Hello" }],
}),
});
console.log(await response.json());
import os
import requests
response = requests.post(
"https://api.adral.ai/v1/chat/completions",
headers={"Authorization": f"Bearer {os.environ['ADRAL_API_KEY']}"},
json={"model": "adral", "messages": [{"role": "user", "content": "Hello"}]},
)
print(response.json())
Python: the sample uses the requests library. Install it with pip install requests.
The response format, error codes and streaming are documented here when the API opens.
5Choose a model
Adral has two models: Adral for general work and Adral Aran for security. Compare the Adral models below.
Adral
The general model. Reasoning, code, long-context analysis and agentic work in one model, with no tiers to choose between.
- Parameters
- 280B total, 14B active
- Architecture
- MoE-Mamba
- Sequence mixer
- Selective state space, linear time, no KV cache
- Experts
- 256 routed + 1 shared, top-8 per token
- Context
- 1M tokens
- Input
- Text, code, images (PNG, JPEG, WebP), .docx, .xlsx
- Available on
- Web, Mac, Windows, Android (iPhone coming soon)
Adral Aran
India’s first uncensored security model, built to engage with offensive and defensive security work rather than decline it.
- Parameters
- 7B total, 1.5B active
- Architecture
- MoE-Mamba
- Sequence mixer
- Selective state space, linear time, no KV cache
- Experts
- 16 routed, top-2 per token
- Input
- Text, code
- Available on
- Web, Mac, Windows, Android (iPhone coming soon)
The samples use adral as the model name. The full list of model names the API
accepts is published here when the API opens.
Limits
Startup keys are on the Startup plan:
- Requests
- 60 per minute
- Tokens
- 10 million per month
The API tab of your startup dashboard always shows the plan and limits that apply to your key.
Keeping your key safe
- Keep it in an environment variable or a secrets manager, never in your source code.
- Call the API from your server, not from a browser or a mobile app, where anyone could read the key.
- Don’t paste it into chats, tickets or screenshots.
- If it leaks, press Regenerate on the API tab. The old key stops working immediately.
Questions and help
When does the API open?
The launch date isn’t announced yet. Create your key now: it starts working the day the API opens, and this page and your dashboard will say so.
Can I see my key again after I close it?
No. The full key is shown once. If you didn’t save it, press Regenerate for a new one.
Where do I see my limits and usage?
On the API tab of your startup dashboard. Per-day usage charts arrive with per-day usage reporting.
Do I need a separate account for the API?
No. Adral for Startups uses your ordinary Adral account, so one sign-in opens your dashboard, your key and the rest of Adral.
Anything else? Write to the Adral team from the Support tab of your dashboard, or email hi@adral.ai.