Chat completions

94 modelos de linguagem de 10 fabricantes em um só endpoint compatível com a OpenAI. Aponte qualquer SDK da OpenAI para a Revana, troque o nome do modelo e pague por token com o mesmo crédito pré-pago de vídeo e imagens.

Fazer uma requisição

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."}]}'

A resposta é o objeto chat.completion da OpenAI. Seu id começa com chat_, e usage acrescenta cost_usd, o valor debitado do seu saldo por esta requisição.

{
  "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
  }
}

SDKs da OpenAI

Toda biblioteca cliente da OpenAI funciona sem alterações: defina a URL base e a chave.

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 ?? "")

Ferramentas como LangChain, LlamaIndex, o Vercel AI SDK, o Cline ou o Open WebUI aceitam as mesmas duas configurações: um provedor compatível com a OpenAI com URL base https://api.revana.si/v1 e a sua chave.

Streaming

Envie "stream": true para server-sent events no formato chat.completion.chunk da OpenAI, terminando com data: [DONE]. Adicione "stream_options": {"include_usage": true} para um último chunk com choices vazio e o usage da requisição, cost_usd incluído.

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}'

Cobrança

• Você paga pelos tokens que o modelo informa: entrada, entrada em cache, gravações em cache e saída (tokens de raciocínio contam como saída), pelo preço do modelo por milhão abaixo. Cobrado até o micro-dólar do mesmo saldo pré-pago das gerações.
• Enquanto uma requisição roda, a Revana reserva o máximo que ela poderia custar: o prompt mais max_tokens (ou max_completion_tokens; 8,192 quando nenhum está definido, e esse é o limite enviado ao modelo). Modelos de raciocínio que podem escrever além de max_tokens, e qualquer requisição com esforço de raciocínio xhigh ou max, reservam a saída completa do modelo. A reserva é liberada quando a requisição termina e apenas os tokens usados são cobrados.
• Uma requisição sem resposta, porque todas as rotas falharam, não custa nada. Um stream que você fecha no meio continua até o fim no modelo e é cobrado pelos tokens que usou.
• Alguns modelos têm preço por tamanho do prompt, horário do dia ou esforço de raciocínio; a página de cada modelo informa isso. O cache automático de prompt funciona como no fabricante do modelo, e os tokens em cache são cobrados pela tarifa de cache; marcadores cache_control explícitos são removidos.
• Apenas texto e imagens (image_url), e apenas ferramentas de função: busca na web, áudio, arquivos e entrada de vídeo, saídas previstas e ferramentas integradas são recusados com 400 unsupported_parameter. Parâmetros fora do conjunto de chat completions da OpenAI são ignorados.
• Todo modelo tem uma rota pelo preço listado. Quando essa rota está ocupada, uma requisição pode rodar em uma rota de reserva e é cobrada pelo custo dessa rota quando for maior, nunca acima da reserva.

Erros

Os erros usam o formato da OpenAI, {"error": {"message", "type", "code"}}, então os SDKs lançam as exceções de sempre: 400 invalid_request | unsupported_parameter, 401, 402 insufficient_credits (recarregue, ou reduza max_tokens), 404 model_not_found, 413 body_too_large (acima de 20 MB), 429 concurrency_limit, 502 model_unavailable e 503 model_busy | busy (tente de novo em alguns segundos; nada foi cobrado).

Modelos e preços

USD por milhão de tokens. Clique em um modelo para ver sua tabela de preços completa. A mesma lista é /data/llms.json.