Adralfor Startups

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: curl in 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.

  1. Sign in to your startup dashboard and open the API tab.
  2. Press Generate API key.
  3. 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"

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"}]}'

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.