Chat completions

94 языковые модели от 10 разработчиков на одном OpenAI-совместимом эндпоинте. Направьте любой SDK OpenAI на Revana, смените название модели и платите за токены из тех же предоплаченных кредитов, что и за видео и изображения.

Отправка запроса

curl https://api.revana.si/v1/chat/completions \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Write a haiku about routing."}]}'

Ответ — объект OpenAI chat.completion. Его id начинается с chat_, а usage добавляет cost_usd — сумму, списанную с вашего баланса за этот запрос.

{
  "id": "chat_3f9c…",
  "object": "chat.completion",
  "created": 1793318400,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Cheapest path first,\nfallback waits in the wings,\nanswers still arrive."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 18,
    "total_tokens": 32,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "cost_usd": 0.000141
  }
}

SDK OpenAI

Любая клиентская библиотека OpenAI работает без изменений: задайте базовый URL и ключ.

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.revana.si/v1", api_key=os.environ["REVANA_API_KEY"])
reply = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Write a haiku about routing."}],
)
print(reply.choices[0].message.content)

import OpenAI from "openai"

const client = new OpenAI({ baseURL: "https://api.revana.si/v1", apiKey: process.env.REVANA_API_KEY })
const stream = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "Write a haiku about routing." }],
  stream: true,
})
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "")

Инструменты вроде LangChain, LlamaIndex, Vercel AI SDK, Cline или Open WebUI принимают те же две настройки: OpenAI-совместимый провайдер с базовым URL https://api.revana.si/v1 и ваш ключ.

Потоковая передача

Передайте "stream": true, чтобы получать server-sent events в формате OpenAI chat.completion.chunk, заканчивающиеся data: [DONE]. Добавьте "stream_options": {"include_usage": true}, чтобы последний фрагмент с пустым choices включал usage и cost_usd запроса.

curl https://api.revana.si/v1/chat/completions \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Write a haiku about routing."}],"stream":true}'

Тарификация

• Вы платите за токены, о которых сообщает модель: входные, кэшированные входные, записи в кэш и выходные (токены рассуждений считаются выходными), по цене модели за миллион ниже. Списание с точностью до микродоллара с того же предоплаченного баланса, что и за генерации.
• Пока запрос выполняется, Revana резервирует максимум, который он может стоить: его промпт плюс max_tokens (или max_completion_tokens; 8192, если ничего не задано, и именно этот лимит передаётся модели). Модели с рассуждениями, которые могут писать сверх max_tokens, и любой запрос с уровнем рассуждений xhigh или max резервируют полный выход модели. Резерв освобождается, когда запрос завершается, и списываются только использованные токены.
• Запрос без ответа, потому что не сработал ни один маршрут, ничего не стоит. Поток, который вы закрыли на полпути, всё равно доходит до конца у модели, и за использованные токены плата списывается.
• Некоторые модели тарифицируются по размеру промпта, времени суток или уровню рассуждений; об этом сказано на странице каждой модели. Автоматическое кэширование промптов работает так же, как у разработчика модели, а кэшированные токены тарифицируются по кэшированной ставке; явные маркеры cache_control удаляются.
• Только текст и картинки (image_url) и только функциональные инструменты: веб-поиск, аудио, файлы и видео на входе, предсказанные выходы и встроенные инструменты отклоняются с 400 unsupported_parameter. Параметры вне набора OpenAI chat completions игнорируются.
• У каждой модели есть маршрут по указанной цене. Когда этот маршрут занят, запрос может выполниться по запасному маршруту, и тогда списывается стоимость этого маршрута, если она выше, но не больше резерва.

Ошибки

Ошибки имеют формат OpenAI, {"error": {"message", "type", "code"}}, поэтому SDK выбрасывают привычные исключения: 400 invalid_request | unsupported_parameter, 401, 402 insufficient_credits (пополните баланс или уменьшите max_tokens), 404 model_not_found, 413 body_too_large (больше 20 МБ), 429 concurrency_limit, 502 model_unavailable и 503 model_busy | busy (повторите через несколько секунд; ничего не списано).

Модели и цены

USD за миллион токенов. Нажмите на модель, чтобы увидеть её полный прайс-лист. Тот же список — /data/llms.json.