Chat completions

94 model bahasa dari 10 pembuat dalam satu endpoint yang kompatibel dengan OpenAI. Arahkan SDK OpenAI mana pun ke Revana, ganti nama model, bayar per token dari kredit prabayar yang sama dengan video dan gambar.

Membuat request

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

Jawabannya adalah objek chat.completion milik OpenAI. id-nya diawali chat_, dan usage menambahkan cost_usd, jumlah yang diambil dari saldo Anda untuk request ini.

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

Setiap library klien OpenAI berfungsi tanpa perubahan: setel base URL dan kuncinya.

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

Alat seperti LangChain, LlamaIndex, Vercel AI SDK, Cline, atau Open WebUI memakai dua pengaturan yang sama: penyedia yang kompatibel dengan OpenAI dengan base URL https://api.revana.si/v1 dan kunci Anda.

Streaming

Kirim "stream": true untuk server-sent events dalam format chat.completion.chunk OpenAI, diakhiri dengan data: [DONE]. Tambahkan "stream_options": {"include_usage": true} untuk chunk terakhir dengan choices kosong dan usage request, termasuk 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}'

Penagihan

• Anda membayar token yang dilaporkan model: input, input cache, penulisan cache, dan output (token reasoning dihitung sebagai output), sesuai harga model per juta token di bawah. Ditagih hingga mikro-dolar dari saldo prabayar yang sama dengan generasi.
• Saat request berjalan, Revana menahan biaya maksimum yang mungkin: prompt-nya plus max_tokens (atau max_completion_tokens; 8.192 jika keduanya tidak disetel, dan itulah batas yang dikirim ke model). Model reasoning yang mungkin menulis melebihi max_tokens, dan request apa pun dengan reasoning effort xhigh atau max, menahan output penuh model. Tahanan dilepas saat request berakhir dan hanya token yang terpakai yang ditagih.
• Request tanpa jawaban, karena semua rute gagal, tidak memakan biaya. Stream yang Anda tutup di tengah jalan tetap berjalan sampai akhir di model, dan ditagih untuk token yang dipakainya.
• Beberapa model menetapkan harga berdasarkan ukuran prompt, waktu, atau reasoning effort; halaman setiap model menyebutkannya. Prompt caching otomatis bekerja seperti di pembuat model, dan token yang di-cache ditagih dengan tarif cache; penanda cache_control eksplisit dihapus.
• Hanya teks dan gambar (image_url), dan hanya function tool: pencarian web, audio, file dan input video, predicted outputs, dan tool bawaan ditolak dengan 400 unsupported_parameter. Parameter di luar set chat completions OpenAI diabaikan.
• Setiap model memiliki rute dengan harga yang tercantum. Saat rute itu sibuk, request dapat berjalan di rute cadangan, dan ditagih sesuai biaya rute itu jika lebih tinggi, tidak pernah melebihi tahanan.

Error

Error memakai bentuk OpenAI, {"error": {"message", "type", "code"}}, sehingga SDK memunculkan exception biasanya: 400 invalid_request | unsupported_parameter, 401, 402 insufficient_credits (isi saldo, atau turunkan max_tokens), 404 model_not_found, 413 body_too_large (di atas 20 MB), 429 concurrency_limit, 502 model_unavailable, dan 503 model_busy | busy (coba ulang dalam beberapa detik; tidak ada yang ditagih).

Model dan harga

USD per juta token. Klik model untuk daftar harga lengkapnya. Daftar yang sama ada di /data/llms.json.