Documentation

1. Get an API key

Create an account, then create a key in the dashboard. Keys are private to your account and can be revoked at any time.

2. Point your client at the base URL

Send your key as a Bearer token (Authorization: Bearer …) or in an x-api-key header. Coding agents such as Cline and Continue work by choosing their “OpenAI compatible” provider and entering this base URL and your key.

OpenAI SDK (Node)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://agentic.trivanexus.com/api/v1",
  apiKey: process.env.TRIVA_API_KEY,
});

const res = await client.chat.completions.create({
  model: "adaptive",
  messages: [{ role: "user", content: "Hello" }],
  stream: true,
});

for await (const chunk of res) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

OpenAI SDK (Python)

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://agentic.trivanexus.com/api/v1",
    api_key=os.environ["TRIVA_API_KEY"],
)

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

Adaptive mode

Request model: "adaptive" and the gateway scores each request's complexity and routes it to a matching tier — fast models for simple turns, frontier models for architecture, debugging and security work. A conversation stays on one model so prompt caching keeps working, and a failed call escalates to the next tier. smart-routing and cline are accepted as aliases.

Adaptive requests are billed at a flat $0.50 / 1M input and $2.00 / 1M output tokens. Each response tells you where it went:

• X-Triva-Routed-Model — the model that served the request
• X-Triva-Tier / X-Triva-Complexity — the tier (1–3) and complexity score (1–5)
• X-Triva-Sticky — whether the conversation's earlier model was reused

Endpoints

Errors

Errors come back as JSON { "error": "…" }. The gateway never substitutes a placeholder reply for a failed request.

Hugging Face free-tier models

Some models are served through Hugging Face Inference Providers on its free tier. Any Hugging Face model can be requested with the huggingface/ prefix. If you self-host TrivaNexus, set HF_TOKEN to enable them.

// Verified free-tier model from Hugging Face Inference Providers
const res = await client.chat.completions.create({
  model: "huggingface/meta-llama/Llama-3.1-8B-Instruct",
  messages: [{ role: "user", content: "Hello" }],
});

console.log(res.choices[0].message.content);