Getting started
Quickstart
From no account to a working setup, in a few minutes.
1. Create an account
Go to Get started. Your browser generates a random 24-character account ID: that ID is your account. There is no email and no password. Store it in a password manager, it cannot be recovered.
2. Add credit
In Dashboard → Billing, pick an amount (from $5) and a currency. Your first top-up gets +5% (up to $100). The balance is credited once the payment is confirmed on-chain.
3. Create an API key
In Dashboard → API keys, create a key and copy it. It starts with sk-unal- and is shown only once. Keep it in an environment variable:
export UNALIGNED_KEY="sk-unal-…"4. Set up your tool
The quickest way: copy the prompt for your tool and paste it into an AI agent that can edit files on your computer, such as Claude Code or Codex, or into any chat to get the steps. It writes the configuration, keeps your key out of git and checks that the key works.
Set up Claude Code on this computer to use Unaligned, an AI API, with my key.
API key: <paste your sk-unal-… key here>
OpenAI-compatible base URL: https://api.unaligned.pw/openai/v1
Anthropic-compatible base URL: https://api.unaligned.pw/anthropic
Model list (public JSON, no key needed): https://api.unaligned.pw/v1/models
Full guide: https://unaligned.pw/docs/claude-code
Steps:
1. Fetch the model list and show it to me as a short table: id, name, context, input and output price (USD per million tokens), and whether it is uncensored or reasoning. Skip models whose status is "down". Then ask me to choose a main model (suggest claude-sonnet-5-5), a stronger one for /model opus (suggest claude-opus-5-5) and a cheap small one for background work (suggest claude-haiku-5-5), and wait for my answer. If I just say "ok", use the suggestions.
2. Add an "env" block to ~/.claude/settings.json (create the file if needed, keep what is already there) with: ANTHROPIC_BASE_URL = "https://api.unaligned.pw/anthropic" (no /v1, Claude Code adds it), ANTHROPIC_AUTH_TOKEN = the key, ANTHROPIC_MODEL and ANTHROPIC_DEFAULT_SONNET_MODEL = the main model, ANTHROPIC_DEFAULT_OPUS_MODEL = the stronger one, ANTHROPIC_DEFAULT_HAIKU_MODEL = the small one.
3. If the main model is not a Claude model, also set CLAUDE_CODE_MAX_CONTEXT_TOKENS to its "context": Claude Code assumes 200,000 otherwise.
4. Never put the key in a project’s .claude/settings.json: it gets committed with the code.
5. If I use the VS Code extension, also add to VS Code’s user settings.json: "claudeCode.environmentVariables" with ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN, and "claudeCode.disableLoginPrompt": true.
6. Then tell me to restart claude, run /logout once if I was logged in with a claude.ai account, and check /status shows the Unaligned URL.
7. Check the key works: curl https://api.unaligned.pw/anthropic/v1/messages -H "Authorization: Bearer <key>" -H "content-type: application/json" -d '{"model": "claude-haiku-5-5", "max_tokens": 16, "messages": [{"role": "user", "content": "Hi"}]}'
200 = ready. 401 = wrong key. 402 = empty balance (top up at https://unaligned.pw/dashboard/billing).
Rules:
- If the key above is still a placeholder, ask me for it before starting. Never commit it or put it in a project file that goes to git.
- Back up any config file before changing it, and keep the settings already there.
- If you can't edit files or run commands here, give me the exact steps and file contents instead.
- When done, tell me in two lines what you changed and how to switch models.Each prompt links to the tool’s full guide, under Coding tools, if you’d rather do it by hand.
5. Or send a request yourself
For your own code, the native format is one request:
curl https://api.unaligned.pw/v1/chat \
-H "Authorization: Bearer $UNALIGNED_KEY" \
-d '{"model": "gpt-6-luna", "prompt": "Hello"}'{
"id": "req_7f3a…",
"model": "gpt-6-luna",
"text": "Hello! How can I help?",
"finish": "stop",
"usage": { "input_tokens": 9, "output_tokens": 7 },
"cost": 0.0000110,
"balance": 20.4999890
}That’s it. Next: the full Chat reference, or plug an existing tool in with the OpenAI or Anthropic format.