relai docs
Build

For Agents

Relai is a drop-in for any OpenAI-compatible SDK. Set the base URL and your Relai key.

OpenAI SDK · Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.tryrelai.xyz/api/v1/gateway/v1",
    api_key="relai_sk_...",
)

resp = client.chat.completions.create(
    model="deepseek/deepseek-chat",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

OpenAI SDK · JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tryrelai.xyz/api/v1/gateway/v1",
  apiKey: "relai_sk_...",
});

const r = await client.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);

Streaming

Set stream: true. Relai meters usage from the final usage chunk, so streamed requests are billed accurately.

Handling 402

A 402 means the balance is exhausted. Catch it, top up, and retry — agents can watch balance via the dashboard endpoint and refill before they run dry.