Docs/Start here
Your first request
How do I run something, in the workspace, the terminal, or from code?
Checked against the code on
Pick whichever fits. All three draw from the same balance and the same catalog.
In the workspace
Sign in, open https://heyaskr.ai/chat, choose a model in the picker and type. The price of the turn is shown before you send and the cost is shown when it finishes. The workspace.
In the terminal
The CLI needs Node 18 or newer and nothing else. It remembers your key and your model.
curl -fsSL https://heyaskr.ai/install.sh | sh
askr login
askraskr login asks for a key from your wallet and saves it. askr on its own opens a conversation. Quote a question to ask once and exit: askr "what changed in HTTP/3?". The CLI.
From your own code
Make a key at https://heyaskr.ai/wallet#api. The base URL is https://heyaskr.ai/v1 and the shape is the OpenAI chat completions API.
export ASKR_KEY="askr_live_..."
curl https://heyaskr.ai/v1/chat/completions \
-H "Authorization: Bearer $ASKR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "Say hello to askr."}]
}'The response is the OpenAI shape plus one field of ours, askr.credits_charged, so your code knows what the call cost without a second request.
{
"id": "chatcmpl-6f1e...",
"object": "chat.completion",
"model": "gpt-5.6-sol",
"choices": [
{ "index": 0, "message": { "role": "assistant", "content": "Hello, askr." }, "finish_reason": "stop" }
],
"usage": { "prompt_tokens": 12, "completion_tokens": 4, "total_tokens": 16 },
"askr": { "credits_charged": 0.0675 }
}Switch models by changing one string
Every chat model in the catalog works with the same request. Ids are exact, so copy them from the catalog rather than guessing: claude-sonnet-5, gemini-3.7-flash, deepseek/deepseek-v4.1-flash.