AAether AI / Docs
Developer documentation

Build with Aether AI.

A single OpenAI-compatible API endpoint for models available through your Aether AI account. Create a key, choose an available model, and send your first request.

OpenAI-compatible API
Base URLhttps://aether.cesiummc.space/v1

Authentication

Every model API request needs a valid Aether AI API key. Sign in to the dashboard, open API Keys, create a key, and store it privately. Keys are account-specific; never embed a secret in public browser code.

Authorization: Bearer YOUR_AETHER_API_KEY
Use server-side requests or a trusted backend proxy. Do not put a permanent API key in a frontend bundle, mobile app source, or public repository.

Quickstart

Set your Aether AI API key in an environment variable, then list the models your account can access. Model availability depends on the configured provider channels and your account's permissions.

curl "https://aether.cesiummc.space/v1/models" \
  -H "Authorization: Bearer $AETHER_API_KEY"

Replace $AETHER_API_KEY with a private environment variable in your shell. In Windows PowerShell, use $env:AETHER_API_KEY instead.

List models

Call GET /v1/models to discover the model IDs currently accessible to your key. Use a returned model ID for inference requests.

GET /v1/models

Requires an API key. A request without one returns HTTP 401.

Chat completions

Send messages through the OpenAI-compatible chat completions endpoint. Replace YOUR_MODEL_ID with a model reported by /v1/models.

curl "https://aether.cesiummc.space/v1/chat/completions" \
  -H "Authorization: Bearer $AETHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Hello, Aether AI!"}
    ]
  }'

Using the OpenAI SDK

Most OpenAI-compatible clients can target Aether AI by changing the base URL and supplying an Aether AI key. For example, with the Python OpenAI SDK:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AETHER_API_KEY"],
    base_url="https://aether.cesiummc.space/v1",
)

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

Different providers and models may support different parameters. Check model capabilities before enabling advanced options.

Common errors

HTTPWhat it meansWhat to check
401Missing or invalid authenticationAPI key and Bearer header
403Request forbiddenAccount, model, or key permissions
429Rate or quota limitQuota, balance, and usage limits
5xxService or upstream errorRetry policy, upstream availability

Quota, model availability, and pricing are controlled through the Aether AI dashboard and may change over time.

Account & security

Sign in to Aether AI to manage API keys, usage, and account settings. Treat API keys like passwords. Set expiration and quotas where available and rotate credentials if exposed. You can use enabled social sign-in providers to access your account.

Support & service status

For account issues, check the Aether AI dashboard. The API exposes /api/status for public service metadata.

This documentation describes the general API interface. A successful connection does not guarantee that every model is available to every account.
© 2026 Aether AI · Documentation for the public API at aether.cesiummc.space.