Chat Completions

94 Sprachmodelle von 10 Herstellern an einem OpenAI-kompatiblen Endpunkt. Richten Sie ein beliebiges OpenAI-SDK auf Revana, ändern Sie den Modellnamen und zahlen Sie pro Token aus demselben vorausbezahlten Guthaben wie für Video und Bilder.

Eine Anfrage stellen

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

Die Antwort ist das chat.completion-Objekt von OpenAI. Ihr id beginnt mit chat_, und usage ergänzt cost_usd, den für diese Anfrage von Ihrem Guthaben abgezogenen Betrag.

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

OpenAI-SDKs

Jede OpenAI-Clientbibliothek funktioniert unverändert: Setzen Sie die Basis-URL und den Schlüssel.

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

Tools wie LangChain, LlamaIndex, das Vercel AI SDK, Cline oder Open WebUI nehmen dieselben beiden Einstellungen: einen OpenAI-kompatiblen Anbieter mit der Basis-URL https://api.revana.si/v1 und Ihrem Schlüssel.

Streaming

Senden Sie "stream": true für Server-Sent Events im chat.completion.chunk-Format von OpenAI, die mit data: [DONE] enden. Fügen Sie "stream_options": {"include_usage": true} hinzu für einen letzten Chunk mit leerem choices und dem usage der Anfrage, cost_usd inklusive.

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

Abrechnung

• Sie zahlen für die Token, die das Modell meldet: Eingabe, zwischengespeicherte Eingabe, Cache-Schreibvorgänge und Ausgabe (Reasoning-Token zählen als Ausgabe), zum Preis des Modells pro Million unten. Berechnet wird auf den Mikrodollar genau, aus demselben vorausbezahlten Guthaben wie Generierungen.
• Während eine Anfrage läuft, reserviert Revana den höchstmöglichen Betrag: ihren Prompt plus max_tokens (oder max_completion_tokens; 8.192, wenn keines gesetzt ist, und das ist das Limit, mit dem das Modell angefragt wird). Reasoning-Modelle, die über max_tokens hinaus schreiben können, und jede Anfrage mit Reasoning-Aufwand xhigh oder max reservieren die volle Ausgabe des Modells. Die Reservierung wird freigegeben, wenn die Anfrage endet, und berechnet werden nur die verbrauchten Token.
• Eine Anfrage ohne Antwort, weil alle Routen fehlgeschlagen sind, kostet nichts. Ein Stream, den Sie mittendrin schließen, läuft beim Modell trotzdem bis zum Ende und wird für die verbrauchten Token berechnet.
• Manche Modelle bepreisen nach Prompt-Größe, Tageszeit oder Reasoning-Aufwand; die Seite jedes Modells sagt das. Automatisches Prompt-Caching funktioniert wie beim Hersteller des Modells, und zwischengespeicherte Token werden zum Cache-Satz abgerechnet; explizite cache_control-Marker werden entfernt.
• Nur Text und Bilder (image_url) und nur Funktions-Tools: Websuche, Audio, Dateien und Videoeingabe, vorhergesagte Ausgaben und integrierte Tools werden mit 400 unsupported_parameter abgelehnt. Parameter außerhalb des Chat-Completions-Satzes von OpenAI werden ignoriert.
• Jedes Modell hat eine Route zu seinem gelisteten Preis. Ist diese Route ausgelastet, kann eine Anfrage über eine Backup-Route laufen und wird mit den Kosten dieser Route berechnet, wo sie höher sind, nie mehr als die Reservierung.

Fehler

Fehler haben die Form von OpenAI, {"error": {"message", "type", "code"}}, sodass SDKs ihre üblichen Ausnahmen auslösen: 400 invalid_request | unsupported_parameter, 401, 402 insufficient_credits (aufladen oder max_tokens senken), 404 model_not_found, 413 body_too_large (über 20 MB), 429 concurrency_limit, 502 model_unavailable und 503 model_busy | busy (in wenigen Sekunden erneut versuchen; es wurde nichts berechnet).

Modelle und Preise

USD pro Million Token. Klicken Sie auf ein Modell für sein vollständiges Preisblatt. Dieselbe Liste ist /data/llms.json.