Chat Completions

10社の94の言語モデルを、OpenAI互換のエンドポイント1つで。どのOpenAI SDKも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
  }
}

OpenAI SDK

どの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などのツールでも、同じ2つの設定をします。ベースURL https://api.revana.si/v1 とあなたのキーを指定したOpenAI互換のプロバイダーです。

ストリーミング

OpenAIの chat.completion.chunk 形式のサーバー送信イベントには "stream": true を送信し、data: [DONE] で終了します。"stream_options": {"include_usage": true} を追加すると、空の choices と、cost_usd を含むリクエストの usage を持つ最後のチャンクが送られます。

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

課金

• 課金されるのは、モデルが報告したトークンで、入力、キャッシュされた入力、キャッシュの書き込み、出力です（推論トークンは出力として数えます）。料金は下のモデルごとの100万トークンあたりの価格で計算されます。生成と同じプリペイドの残高から、マイクロドル単位で課金されます。
• リクエストの実行中、Revanaは、かかりうる最大額を確保します。プロンプトに max_tokens（または max_completion_tokens。どちらも未設定の場合は8,192で、これがモデルに送られる上限です）を加えた分です。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 MB超）、429 concurrency_limit、502 model_unavailable、503 model_busy | busy（数秒後に再試行してください。課金はありません）です。

モデルと料金

100万トークンあたりの米ドル価格です。モデルをクリックすると、完全な料金表が表示されます。同じ一覧は /data/llms.json にもあります。