Quickstart

1. Add funds. Open the Developers page in the Aderra app (any account, Free included). Click Add funds, enter any amount from $5 and click Pay by card or Pay with crypto. The credits arrive once the payment is confirmed. See Pricing and the API wallet.

2. Create a key. Click Create key, give it a name and click Create key again. Copy the key: it starts with ak_ and is shown once.

3. Keep the key out of your code. Put it in an environment variable:

   export ADERRA_API_KEY=ak_...

4. Make a call.

   cURL

   curl https://api.aderra.ai/v1/chat/completions \
     -H "Authorization: Bearer $ADERRA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "deepseek-v4.1-flash-uncensored",
       "max_tokens": 1024,
       "messages": [{"role": "user", "content": "Write a haiku about the sea."}]
     }'

   Python

   pip install openai

   import os
   from openai import OpenAI
   
   client = OpenAI(
       base_url="https://api.aderra.ai/v1",
       api_key=os.environ["ADERRA_API_KEY"],
   )
   
   reply = client.chat.completions.create(
       model="deepseek-v4.1-flash-uncensored",
       max_tokens=1024,
       messages=[{"role": "user", "content": "Write a haiku about the sea."}],
   )
   print(reply.choices[0].message.content)

   Node

   npm install openai

   import OpenAI from 'openai';
   
   const client = new OpenAI({
     baseURL: 'https://api.aderra.ai/v1',
     apiKey: process.env.ADERRA_API_KEY,
   });
   
   const reply = await client.chat.completions.create({
     model: 'deepseek-v4.1-flash-uncensored',
     max_tokens: 1024,
     messages: [{ role: 'user', content: 'Write a haiku about the sea.' }],
   });
   console.log(reply.choices[0].message.content);

5. See it on the Developers page. The call appears under Requests, with its tokens, cost and duration.

You can create a key before adding funds, but every call is refused with 402 api_wallet_empty until the wallet holds credits.

Caution

Anyone with your key can spend your wallet. Never ship it in a browser, a mobile app or a public repository: call the API from your server. If a key leaks, revoke it on the Developers page straight away.

Stream the answer

Add stream: true to get the reply as it is written.

cURL

curl -N https://api.aderra.ai/v1/chat/completions \
  -H "Authorization: Bearer $ADERRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash-uncensored",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "Write a haiku about the sea."}]
  }'

Python

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash-uncensored",
    max_tokens=1024,
    stream=True,
    messages=[{"role": "user", "content": "Write a haiku about the sea."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

Node

const stream = await client.chat.completions.create({
  model: 'deepseek-v4.1-flash-uncensored',
  max_tokens: 1024,
  stream: true,
  messages: [{ role: 'user', content: 'Write a haiku about the sea.' }],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}
process.stdout.write('\n');

Next steps

• Prefer the Anthropic SDK? See Anthropic Messages.
• Pick a model: Models.
• Make images, video and speech: Images, Video, Text to speech.
• Before you go to production: Rate limits and Errors.