Documentation
Autarcho serves open models through an OpenAI-compatible API. You pay for the tokens a model generates and nothing for the prompt, so a long document costs whatever the answer costs.
Getting started
The base URL is https://api.autarcho.com/v1. Every request carries a key in the Authorization header. A key is ak_ followed by 64 hex characters, and
you make it yourself rather than signing up for it.
printf 'ak_%s\n' "$(openssl rand -hex 32)"
Only a hash of the key is stored, so the key is the only copy. Save it before you close the terminal.
Add credit
Credit is bought with USDC on Solana. Ask for a payment request, pay the address it returns, and the balance appears under that key once the transfer confirms.
curl -s -X POST "https://api.autarcho.com/deposits/intent?amount=10" \ -H "Authorization: Bearer ak_..."
The response includes a solana_pay_url you can open in any Solana wallet. The payment walkthrough covers the whole step, including what to do if the
credit does not arrive.
Send a request
curl -s https://api.autarcho.com/v1/chat/completions \
-H "Authorization: Bearer ak_..." \
-H "content-type: application/json" \
-d '{
"model": "<model id>",
"messages": [{ "role": "user", "content": "Hello" }],
"stream": true
}' The same request through the OpenAI SDK, which needs only a new base URL and key.
from openai import OpenAI
client = OpenAI(base_url="https://api.autarcho.com/v1", api_key="ak_...")
stream = client.chat.completions.create(
model="<model id>",
messages=[{"role": "user", "content": "Hello"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="") Find a model
GET /v1/models lists the models available to your key. A model id is the hash of the
file, or an alias for it, and either works in a request.
curl -s https://api.autarcho.com/v1/models \ -H "Authorization: Bearer ak_..."
Prices are set per model and can change. To read one without a key, ask for it directly:
curl -s "https://api.autarcho.com/model/<hash>/price?for_client=true"
The models page has a price and a file size for each one.
Next
- API reference: every parameter, and what happens with a stream.
- Billing: what a request costs and how to retry without paying twice.
- Batch requests: send a list of requests and collect the answers later.
A program that reads one file: llms-full.txt is this documentation as plain text.