One route
for every model.

Make your first request.

Open the workspace to test a model and create an API key. Keep the raw key private; it is shown only once.

curl https://api.aethera.com/v1/chat/completions \\
  -H "Authorization: Bearer ${AETHERA_API_KEY}" \\
  -H "Idempotency-Key: replace-with-unique-request-id" \\
  -H "Content-Type: application/json" \\
  -d '{"model":"public-api","messages":[{"role":"user","content":"Hello"}]}'

Use a fresh idempotency key for each logical request. Repeating the same key and payload returns its stored result; reusing the key with a different payload returns HTTP 409. Keys are scoped to the authenticated user.

Authenticate once.

Send your API key as a Bearer token to public API endpoints. The authenticated workspace uses its browser session. Never place a key in client-side browser code.

Never expose an API key in browser code or commit it to source control.

Choose a public alias.

List enabled public aliases before making a request. Pricing and availability are controlled by the active server catalog.

Chat completions.

Send a JSON body with a public model alias and messages. Include a unique Idempotency-Key header for each logical request; the endpoint rejects a missing key with HTTP 400.

{
  "model": "public-api",
  "messages": [{"role": "user", "content": "Your prompt"}],
  "temperature": 0.7
}

Usage becomes a record.

Each completed request records usage and its wallet settlement in the request history and ledger. USD is the canonical billing currency.

Handle errors clearly.

Errors use JSON responses with a useful detail or normalized error message. Check the HTTP status and do not charge a failed request client-side. Request history and the ledger in the workspace are the source of truth.

When a request fails, inspect the response status and error payload before retrying. Use a new idempotency key only for a new logical request.