Chat completions

10개 제작사의 94개 언어 모델을 하나의 OpenAI 호환 엔드포인트에서. 아무 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 같은 도구도 같은 두 가지 설정을 받습니다. 베이스 URL https://api.revana.si/v1과 키가 있는 OpenAI 호환 제공업체입니다.

스트리밍

"stream": true를 보내면 OpenAI의 chat.completion.chunk 형식의 서버 전송 이벤트(SSE)를 받으며 data: [DONE]로 끝납니다. "stream_options": {"include_usage": true}를 추가하면 빈 choices와 요청의 usage, 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}'

결제

• 모델이 보고하는 토큰에 대해 지불합니다. 입력, 캐시된 입력, 캐시 쓰기, 출력(추론 토큰은 출력으로 계산)이며, 아래에 있는 모델의 백만 토큰당 가격이 적용됩니다. 생성과 같은 선불 잔액에서 마이크로 달러 단위로 청구됩니다.
• 요청이 실행되는 동안 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(몇 초 후에 재시도하세요. 요금은 청구되지 않았습니다).

모델과 가격

백만 토큰당 USD입니다. 모델을 클릭하면 전체 가격표가 표시됩니다. 같은 목록이 /data/llms.json입니다.