Get your API key

Sign up and open Dashboard → API Keys. Copy the secret when shown — you can reveal saved keys later.

Make your first request

curl https://api.hadexs.com/v1/chat/completions \
  -H "Authorization: Bearer hadexs_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hades-1.0",
    "messages": [{"role": "user", "content": "Explain quantum computing in simple terms"}]
  }'

Use the Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="hadexs_sk_...",
    base_url="https://api.hadexs.com/v1",
)

completion = client.chat.completions.create(
    model="hades-1.0",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(completion.choices[0].message.content)

Use with Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "hadexs_sk_...",
  baseURL: "https://api.hadexs.com/v1",
});

const response = await client.chat.completions.create({
  model: "hades-1.0",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);

API Keys

Create keys in the dashboard. Each key begins with hadexs_sk_.

Request Headers

Authorization: Bearer hadexs_sk_...

Security Best Practices

• Never expose API keys in client-side browser code
• Store keys in environment variables, not source code
• Rotate keys immediately if compromised
• Create separate keys per application or environment
• Delete unused keys from your dashboard

Create a key

Open Dashboard → API Keys and click Create API Key. Name keys by environment (Production, Staging, Local).

Reveal & rotate

Use the eye icon to reveal a saved key. Delete and recreate to rotate.

Dashboard

Manage keys, usage, and billing from the developer dashboard.

Limits by Tier

Rate Limit Headers

x-ratelimit-limit-requests: 30
x-ratelimit-limit-tokens: 14400
x-ratelimit-remaining-requests: 28
x-ratelimit-remaining-tokens: 13122
x-ratelimit-reset-requests: 2s
x-ratelimit-reset-tokens: 1s

Handling 429 Errors

Retry with exponential backoff or upgrade your plan for higher limits.

Request Body

Example Request

curl https://api.hadexs.com/v1/chat/completions \
  -H "Authorization: Bearer hadexs_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hades-1.0",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is 2 + 2?"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

from openai import OpenAI
client = OpenAI(api_key="hadexs_sk_...", base_url="https://api.hadexs.com/v1")
print(client.chat.completions.create(
  model="hades-1.0",
  messages=[{"role": "user", "content": "What is 2 + 2?"}],
).choices[0].message.content)

import OpenAI from "openai";
const client = new OpenAI({ apiKey: "hadexs_sk_...", baseURL: "https://api.hadexs.com/v1" });
const res = await client.chat.completions.create({
  model: "hades-1.0",
  messages: [{ role: "user", content: "What is 2 + 2?" }],
});
console.log(res.choices[0].message.content);

Example Response

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "hades-1.0",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "2 + 2 equals 4." },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 24, "completion_tokens": 9, "total_tokens": 33 }
}

Language Models

Audio Models

List Models via API

curl https://api.hadexs.com/v1/models \
  -H "Authorization: Bearer hadexs_sk_..."

Enable streaming

Set stream: true on chat completion requests.

stream = client.chat.completions.create(
  model="hades-1.0",
  messages=[{"role": "user", "content": "Tell me a story"}],
  stream=True,
)
for chunk in stream:
  if chunk.choices[0].delta.content:
    print(chunk.choices[0].delta.content, end="", flush=True)

Stream Format

Each SSE line is a JSON object with choices[0].delta.content fragments until [DONE].

Endpoint

Request

Pass prompt, model (hades-image or tiered ids), and optional size.

Image models

hades-1.5 and hades-2.0 image tiers map to your plan. See Pricing for daily image allowances.

Tools parameter

Define JSON-schema functions the model may invoke; handle tool calls in your app loop.

Example

See OpenAI tool calling docs — Hades accepts the same request shape at /v1/chat/completions.

HTTP status codes

• 401 — invalid or missing API key
• 429 — rate limit exceeded
• 500 — server error (retry with backoff)

Error shape

{ "error": { "message": "...", "type": "invalid_request_error", "code": "..." } }

Keys & security

Use server-side proxies; never ship hadexs_sk_ keys to browsers.

Retries

Retry idempotent requests on 429/5xx with jittered exponential backoff.

Production

Separate keys per service, monitor usage in the dashboard, and set wallet alerts before launch.

Recent releases

API v1 chat, streaming, dashboard billing, and docs refresh — October 2026.

Discord

Join the Hades Discord for help and product updates.

GitHub

SDK examples and CLI tooling ship from the Hades org on GitHub.

Uptime

All systems operational. Subscribe to status alerts at status.hadexs.com.

Contact

Email support@hadexs.com or use in-app chat on paid plans. For Zunos agent workflows, see Zunos.