Docs

Chat completions

101 language models from 10 makers on one OpenAI-compatible endpoint. Point any OpenAI SDK at Revana, change the model name, pay per token from the same prepaid credit as video and images.

Point de terminaisonPOST https://api.revana.si/v1/chat/completions
URL de base pour les SDKhttps://api.revana.si/v1
AuthentificationAuthorization: Bearer <key> (votre clé API Revana)
RequêteLe corps des chat completions d'OpenAI : model, messages, stream, max_tokens, tools, response_format, reasoning_effort…
ModèlesGET /v1/models les liste avec "kind": "text" et leurs prix au token ; également /data/llms.json
PrixUSD par million de tokens, par modèle, ci-dessous. Sans abonnement.

Faire une requête

POSThttps://api.revana.si/v1/chat/completions
curl
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."}]}'

La réponse est l'objet chat.completion d'OpenAI. Son id commence par chat_, et usage ajoute cost_usd, le montant prélevé sur votre solde pour cette requête.

Réponse
{
  "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

Toutes les bibliothèques clientes OpenAI fonctionnent telles quelles : définissez l'URL de base et la clé.

Python
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)
Node.js (streaming)
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 ?? "")

Des outils comme LangChain, LlamaIndex, le Vercel AI SDK, Cline ou Open WebUI utilisent les mêmes deux réglages : un fournisseur compatible OpenAI avec l'URL de base https://api.revana.si/v1 et votre clé.

Streaming

Envoyez "stream": true pour des server-sent events au format chat.completion.chunk d'OpenAI, se terminant par data: [DONE]. Ajoutez "stream_options": {"include_usage": true} pour un dernier chunk avec choices vide et le usage de la requête, cost_usd inclus.

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

Facturation

  • Vous payez les tokens que le modèle déclare : entrée, entrée en cache, écritures en cache et sortie (les tokens de raisonnement comptent comme sortie), au prix par million du modèle indiqué ci-dessous. Débité au micro-dollar sur le même solde prépayé que les générations.
  • Pendant qu'une requête s'exécute, Revana bloque le maximum qu'elle pourrait coûter : son prompt plus max_tokens (ou max_completion_tokens ; 8,192 quand aucun n'est défini, et c'est la limite envoyée au modèle). Les modèles de raisonnement qui peuvent écrire au-delà de max_tokens, et toute requête avec un niveau de raisonnement xhigh ou max, bloquent la sortie complète du modèle. Le montant bloqué est libéré à la fin de la requête et seuls les tokens utilisés sont facturés.
  • Une requête sans réponse, parce que toutes les routes ont échoué, ne coûte rien. Un flux que vous fermez en cours de route continue de s'exécuter jusqu'au bout côté modèle, et est facturé pour les tokens qu'il a utilisés.
  • Certains modèles tarifent selon la taille du prompt, l'heure de la journée ou le niveau de raisonnement ; la page de chaque modèle l'indique. La mise en cache automatique des prompts fonctionne comme chez l'éditeur du modèle, et les tokens en cache sont facturés au tarif du cache ; les marqueurs cache_control explicites sont supprimés.
  • Texte et images (image_url) uniquement, et seulement des outils de type fonction : la recherche web, l'audio, les fichiers et la vidéo en entrée, les sorties prédites et les outils intégrés sont refusés avec 400 unsupported_parameter. Les paramètres en dehors de l'ensemble des chat completions d'OpenAI sont ignorés.
  • Chaque modèle a une route à son prix listé. Quand cette route est saturée, une requête peut s'exécuter sur une route de secours, et est facturée au coût de cette route quand il est plus élevé, sans jamais dépasser le montant bloqué.

Erreurs

Les erreurs suivent la forme d'OpenAI, {"error": {"message", "type", "code"}}, de sorte que les SDK lèvent leurs exceptions habituelles : 400 invalid_request | unsupported_parameter, 401, 402 insufficient_credits (rechargez, ou réduisez max_tokens), 404 model_not_found, 413 body_too_large (plus de 20 Mo), 429 concurrency_limit, 502 model_unavailable et 503 model_busy | busy (réessayez dans quelques secondes ; rien n'a été facturé).

Modèles et prix

USD par million de tokens. Cliquez sur un modèle pour voir sa grille de prix complète. La même liste est /data/llms.json.

ModèleEntréeEn cacheSortieContexte
Claude Fable 5claude-fable-5 · Anthropic$5.60$0.56$28.001M
Claude Fable 5.1claude-fable-5-1 · Anthropic$5.60$0.14$28.001M
Claude Fable 5.2claude-fable-5-2 · Anthropic$4.48$0.112$22.401M
Claude Haiku 4.5claude-haiku-4-5-20251001 · Anthropic$1.44$0.144$7.20128K
Claude Haiku 4.5 (thinking)claude-haiku-4-5-20251001-thinking · Anthropic$1.44$1.44$7.20—
Claude Haiku 5.5claude-haiku-5-5 · Anthropic$0.056$0.0056$0.281M
Claude Opus 4.5claude-opus-4-5-20251101 · Anthropic$7.20$7.20$36.00—
Claude Opus 4.5 (thinking)claude-opus-4-5-20251101-thinking · Anthropic$7.20$7.20$36.00—
Claude Opus 4.6claude-opus-4-6 · Anthropic$7.20$0.72$14.401M
Claude Opus 4.6 (thinking)claude-opus-4-6-thinking · Anthropic$7.20$7.20$36.00—
Claude Opus 4.7claude-opus-4-7 · Anthropic$7.20$0.72$36.00128K
Claude Opus 4.8claude-opus-4-8 · Anthropic$2.80$0.28$14.001M
Claude Opus 5claude-opus-5 · Anthropic$2.80$0.28$14.001M
Claude Opus 5.5claude-opus-5-5 · Anthropic$2.24$0.112$11.201M
Claude Sonnet 4.5claude-sonnet-4-5-20250929 · Anthropic$4.32$0.432$21.60128K
Claude Sonnet 4.5 (thinking)claude-sonnet-4-5-20250929-thinking · Anthropic$4.32$4.32$21.60—
Claude Sonnet 4.6claude-sonnet-4-6 · Anthropic$4.32$0.432$21.60128K
Claude Sonnet 4.6 (thinking)claude-sonnet-4-6-thinking · Anthropic$4.32$4.32$21.60—
Claude Sonnet 5claude-sonnet-5 · Anthropic$1.12$0.112$5.601M
Claude Sonnet 5.5claude-sonnet-5-5 · Anthropic$1.12$0.056$5.601M
DeepSeek R1deepseek-r1 · DeepSeek$0.8064$0.8064$3.2256—
DeepSeek V3.2deepseek-v3.2 · DeepSeek$0.3701$0.3701$0.5552—
DeepSeek V4 Flashdeepseek-v4-flash · DeepSeek$0.6172$0.0618$1.85151M
DeepSeek V4 Prodeepseek-v4-pro · DeepSeek$0.6336$0.0212$1.90081M
DeepSeek V4.1 Flashdeepseek-v4.1-flash · DeepSeek$0.144$0.0029$0.5761M
Gemini 3 Flash Previewgemini-3-flash-preview · Google$0.72$0.72$4.32—
Gemini 3 Flash Preview (no thinking)gemini-3-flash-preview-nothinking · Google$0.72$0.72$4.32—
Gemini 3 Flash Preview (thinking)gemini-3-flash-preview-thinking · Google$0.72$0.72$4.32—
Gemini 3 Pro Previewgemini-3-pro-preview · Google$2.88$2.88$17.28—
Gemini 3 Pro Preview (thinking)gemini-3-pro-preview-thinking · Google$2.88$2.88$17.28—
Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-preview · Google$0.36$0.36$2.16—
Gemini 3.1 Pro Previewgemini-3.1-pro-preview · Google$2.88$2.88$17.28—
Gemini 3.1 Pro Preview (thinking)gemini-3.1-pro-preview-thinking · Google$2.88$2.88$17.28—
Gemini 3.5 Flashgemini-3.5-flash · Google$2.16$2.16$12.96—
Gemini 3.5 Flash Litegemini-3.5-flash-lite · Google$0.432$0.432$3.5986—
Gemini 3.6 Flashgemini-3.6-flash · Google$2.16$0.216$10.801.05M
Gemini 3.7 Flashgemini-3.7-flash · Google$1.08$0.108$5.401.05M
Gemini 3.8 Flashgemini-3.8-flash · Google$0.36$0.036$1.801M
Gemini 4 Argongemini-4-argon · Google$0.96$0.048$4.801M
Gemini 4 Hydrogengemini-4-hydrogen · Google$2.16$0.108$10.80128K
Kimi K2.5kimi-k2.5 · Kimi$0.7402$0.7402$0.9993—
Kimi K2.6kimi-k2.6 · Kimi$0.912$0.1536$3.84256K
Kimi K2.7 Codekimi-k2.7-code · Kimi$0.912$0.1824$3.84256K
Kimi K3kimi-k3 · Kimi$2.88$0.288$14.401M
Kimi K3.1 Prokimi-k3.1-pro · Kimi$1.92$0.192$9.601M
Kimi K3.1 Pro Highspeedkimi-k3.1-pro-highspeed · Kimi$3.84$0.192$19.201M
MiniMax M2.5minimax-m2.5 · MiniMax$0.432$0.432$1.728—
MiniMax M3minimax-m3 · MiniMax$0.432$0.432$1.728—
GPT-4.1gpt-4.1 · OpenAI$2.88$0.72$11.52128K
GPT-4.1 minigpt-4.1-mini · OpenAI$0.576$0.144$2.304128K
GPT-4.1 nanogpt-4.1-nano · OpenAI$0.144$0.036$0.576128K
GPT-4ogpt-4o · OpenAI$3.60$1.80$14.40128K
GPT-4o minigpt-4o-mini · OpenAI$0.216$0.216$0.864—
GPT-5gpt-5 · OpenAI$1.80$0.18$14.40128K
GPT-5 minigpt-5-mini · OpenAI$0.36$0.036$2.88128K
GPT-5 nanogpt-5-nano · OpenAI$0.072$0.0072$0.576128K
GPT-5.1gpt-5.1 · OpenAI$1.80$0.18$14.40128K
GPT-5.2gpt-5.2 · OpenAI$2.52$0.252$20.16128K
GPT-5.3 Codexgpt-5.3-codex · OpenAI$2.52$2.52$20.16—
GPT-5.4gpt-5.4 · OpenAI$3.60$0.36$21.601M
GPT-5.4 minigpt-5.4-mini · OpenAI$1.08$0.108$6.48128K
GPT-5.4 nanogpt-5.4-nano · OpenAI$0.288$0.0288$1.80128K
GPT-5.5gpt-5.5 · OpenAI$1.84$0.184$11.041.05M
GPT-5.6 Lunagpt-5.6-luna · OpenAI$0.288$0.0288$1.728922K
GPT-5.6 Solgpt-5.6-sol · OpenAI$1.472$0.1472$7.361.05M
GPT-5.6 Terragpt-5.6-terra · OpenAI$0.736$0.0736$4.4161.05M
GPT-6 Astragpt-6-astra · OpenAI$3.68$0.368$18.401.05M
GPT-6 Lunagpt-6-luna · OpenAI$0.144$0.0144$0.72922K
GPT-6 Solgpt-6-sol · OpenAI$0.736$0.0736$3.681.05M
GPT-6.1 Solgpt-6.1-sol · OpenAI$0.736$0.0368$3.681.05M
GPT-6.1 Terragpt-6.1-terra · OpenAI$0.368$0.0184$1.841.05M
o3o3 · OpenAI$2.88$2.88$11.52—
o3-minio3-mini · OpenAI$1.584$0.792$6.336128K
o3-mini (high)o3-mini-high · OpenAI$1.584$1.584$6.336—
o3-mini (low)o3-mini-low · OpenAI$1.584$1.584$6.336—
o3-mini (medium)o3-mini-medium · OpenAI$1.584$1.584$6.336—
o4-minio4-mini · OpenAI$1.584$0.396$6.336128K
Qwen3.6-Flashqwen3.6-flash · Qwen$0.2469$0.2469$1.4809—
Qwen3.6-Plusqwen3.6-plus · Qwen$0.4116$0.4116$2.4694—
Qwen3.7-Flashqwen3.7-flash · Qwen$0.0412$0.0083$0.1646984K
Qwen3.7-Maxqwen3.7-max · Qwen$2.4685$2.4685$7.4054—
Qwen3.7-Plusqwen3.7-plus · Qwen$0.4116$0.4116$1.6463—
Qwen3.8 2.4T-A95Bqwen3.8-2.4t-a95b · Qwen$2.4686$0.3086$7.4058984K
Qwen3.8 27Bqwen3.8-27b · Qwen$0.6172$0.1235$2.4686984K
Qwen3.8-Flashqwen3.8-flash · Qwen$0.1646$0.0206$0.5555984K
Qwen3.8-Maxqwen3.8-max · Qwen$1.92$0.24$5.761M
Step 3.7 Flashstep-3.7-flash · StepFun$0.2777$0.2777$1.6658—
Grok 4.3grok-4.3 · xAI$1.80$1.80$3.60—
Grok 4.5grok-4.5 · xAI$0.96$0.144$2.88500K
Grok 4.6grok-4.6 · xAI$2.88$0.72$8.64500K
Grok 4.7grok-4.7 · xAI$0.96$0.24$2.88500K
Grok 4.20 (non-reasoning)grok-4.20-0309-non-reasoning · xAI$1.80$1.80$3.60—
Grok 4.20 (reasoning)grok-4.20-0309-reasoning · xAI$1.80$1.80$3.60—
Grok 4.20 Multi-Agentgrok-4.20-multi-agent-0309 · xAI$1.80$1.80$3.60—
Grok Build 0.1grok-build-0.1 · xAI$1.44$1.44$2.88—
GLM-5glm-5 · Zhipu GLM$1.44$1.44$2.304—
GLM-5.1glm-5.1 · Zhipu GLM$1.44$1.44$2.592200K
GLM-5.2glm-5.2 · Zhipu GLM$1.344$0.2496$4.2241M
GLM-5.3glm-5.3 · Zhipu GLM$1.344$0.2496$4.2241M
GLM-5.3 Flashglm-5.3-flash · Zhipu GLM$0.108$0.0216$0.361M
GLM-5.3 FlashXglm-5.3-flashx · Zhipu GLM$0.3552$0.072$1.201M