POST https://api.ethereal.llc/v1/chat/completions
Основной эндпоинт. Формат запроса и ответа совпадает с OpenAI Chat Completions,
поэтому работают официальные OpenAI SDK.
Заголовки
| Заголовок | Значение |
|---|
Authorization | Bearer eth-... (или x-api-key: eth-...) |
Content-Type | application/json |
Параметры тела
ID модели: claude-opus-4-8, claude-sonnet-4-6 или claude-haiku-4-5.
Список сообщений. Каждое — { "role": "system" | "user" | "assistant", "content": string }.
Если true — ответ приходит потоком (SSE). См. Стриминг.
Максимум токенов в ответе.
Креативность, 0–2. Меньше — детерминированнее.
Nucleus sampling, альтернатива temperature.
Пример запроса
curl https://api.ethereal.llc/v1/chat/completions \
-H "Authorization: Bearer eth-..." \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{ "role": "system", "content": "Ты лаконичный ассистент." },
{ "role": "user", "content": "Объясни рекурсию в одном предложении." }
],
"max_tokens": 200
}'
Ответ
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1780000000,
"model": "claude-sonnet-4-6",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "Рекурсия — это когда функция вызывает саму себя до достижения базового случая." },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 28, "completion_tokens": 17, "total_tokens": 45 }
}
Поле usage показывает потраченные токены — по ним и считается списание
(Тарифы).