Skip to main content
Все запросы к API авторизуются по ключу вида eth-.... Создать и отозвать ключи можно в личном кабинете → API-ключи.
Ключ даёт доступ к балансу. Не публикуйте его в репозиториях и фронтенде — держите в переменных окружения и серверном коде.

Способ 1 — Bearer (рекомендуется)

OpenAI-совместимый заголовок. Подходит для всех OpenAI SDK.
curl https://api.ethereal.llc/v1/chat/completions \
  -H "Authorization: Bearer eth-..." \
  -H "Content-Type: application/json" \
  -d '{ "model": "claude-haiku-4-5", "messages": [{"role":"user","content":"ping"}] }'

Способ 2 — x-api-key

Для клиентов, привыкших к Anthropic-стилю заголовка.
curl https://api.ethereal.llc/v1/chat/completions \
  -H "x-api-key: eth-..." \
  -H "Content-Type: application/json" \
  -d '{ "model": "claude-haiku-4-5", "messages": [{"role":"user","content":"ping"}] }'

Переменные окружения

Большинство инструментов читают ключ и базовый URL из окружения:
export ETHEREAL_API_KEY="eth-..."
# для OpenAI-совместимых SDK:
export OPENAI_API_KEY="eth-..."
export OPENAI_BASE_URL="https://api.ethereal.llc/v1"

Ротация и отзыв

  • Можно держать несколько ключей (например, по проекту/окружению).
  • Отозванный ключ перестаёт работать сразу.
  • При утечке — удалите ключ в кабинете и создайте новый.
Тело запросов не логируется — для биллинга хранятся только метаданные (модель, число токенов, время). См. FAQ.