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
askr

askr 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.

Response
{
  "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.