Atris API examples

Working examples for the Atris API. Every request is billed from actual model usage, and every request comes with a receipt you can fetch.

Base URL: https://api.atris.ai

Machine-readable guide (point your agent at this): https://api.atris.ai/llms.txt

Get a key

1. Sign in at atris.ai.
2. Open Settings, then Developer.
3. Create a key. The full secret is shown once, so copy it then.

Set it in your shell:

export ATRIS_API_KEY="atris_..."

Send your first message

The chat endpoint is OpenAI-compatible, so the OpenAI SDKs work as-is. Point them at our base URL:

import os

from openai import OpenAI

client = OpenAI(
    base_url="https://api.atris.ai/v1",
    api_key=os.environ["ATRIS_API_KEY"],
)

reply = client.chat.completions.create(
    model="atris:auto",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

Or with plain curl:

curl https://api.atris.ai/v1/chat/completions \
  -H "x-atris-api-key: $ATRIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"atris:auto","messages":[{"role":"user","content":"Hello"}]}'

What's in this repo

File	Shows
examples/chat.sh	One chat request with curl
examples/chat.py	Chat with the OpenAI Python SDK, plus streaming
examples/chat.js	Chat with the OpenAI Node SDK
examples/receipt.py	Fetch the billing receipt for a request
examples/keys.sh	List keys, check balance, see per-key usage

Billing

One credit is $0.01. Requests bill from actual model usage at Atris rates, with a $0.01 minimum per request.

Every chat response includes an atris object with the request id, credits charged, dollar cost, and your remaining balance. Fetch the durable receipt any time:

curl https://api.atris.ai/api/atris2/billing/receipts/REQUEST_ID \
  -H "x-atris-api-key: $ATRIS_API_KEY"

Managing keys

# List your keys
curl https://api.atris.ai/api/developer/keys -H "x-atris-api-key: $ATRIS_API_KEY"

# Per-key usage
curl https://api.atris.ai/api/developer/keys/AGENT_ID/usage -H "x-atris-api-key: $ATRIS_API_KEY"

# Rotate (new secret shown once, old key stops working)
curl -X POST https://api.atris.ai/api/developer/keys/AGENT_ID/rotate -H "x-atris-api-key: $ATRIS_API_KEY"

# Revoke
curl -X DELETE https://api.atris.ai/api/developer/keys/AGENT_ID -H "x-atris-api-key: $ATRIS_API_KEY"

# Balance
curl https://api.atris.ai/api/credits/balance -H "x-atris-api-key: $ATRIS_API_KEY"

Auth reference

Two ways to authenticate:

• x-atris-api-key: atris_... with a developer key (use this for code and agents)
• Authorization: Bearer <JWT> with a signed-in session (this is what the dashboard uses)

Keys are created with a JWT via POST /api/developer/create-key. The secret is revealed once in that response.