Quickstart
Create a key, add credit, and make your first routed request.
Set up with a coding agent
Copy this prompt into your coding agent and it will make the integration in your project, following our agent guide. Or follow the steps below by hand.
Set up Telluvian routing in this project. 1. Read https://telluvian.ai/docs/agents/routing.md before changing anything. 2. Find where this project calls an LLM (OpenAI SDK or compatible). 3. Point it at https://api.telluvian.ai/v1 with model "telluvian/gallery-1". 4. Read the key from TELLUVIAN_API_KEY. Add it to .env.example; never hard-code it. If I don't have a key yet, tell me to create one at https://telluvian.ai/dashboard/keys. 5. Log the response's `model` field so I can see which model answered. 6. Make one test request and show me the result. Ask before changing production defaults. 7. Ask whether I want to use my own OpenAI, Anthropic, Google AI Studio or OpenRouter key (BYOK; see https://telluvian.ai/docs/byok.md). Those keys are added in the dashboard at https://telluvian.ai/dashboard/provider-keys, never in this project's code or .env. If I do, log the response's `usage.byok_credential` to show which key served each request.
Paste it into Claude Code, Cursor, Codex or any coding agent, from your project folder. Agent without web access? or download AGENTS.routing.md.
1. Create an API key
Mint one in the dashboard. The key is shown once and cannot be recovered afterwards, so store it somewhere safe.
2. Add credit
Billing is prepaid and denominated in dollars. A $25 payment adds $25 of API
credit. Add credit; requests are refused with a 402
until your balance is positive.
3. Send a request
Send telluvian/gallery-1 and we pick the model. Probing is off by default;
include_scores: false makes that choice explicit.
curl https://api.telluvian.ai/v1/chat/completions \
-H "Authorization: Bearer $TELLUVIAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "telluvian/gallery-1",
"messages": [{"role": "user", "content": "When was the Eiffel Tower built?"}],
"include_scores": false
}'You can also name a model yourself. Any id from GET /v1/models works in place
of telluvian/gallery-1, and the rest of the request is identical.
4. Add verification
Set include_scores: true to request per-token hallucination scores. A token
whose probe reading is unavailable has a null score.
curl https://api.telluvian.ai/v1/chat/completions \
-H "Authorization: Bearer $TELLUVIAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "telluvian/gallery-1",
"messages": [
{
"role": "user",
"content": "When was the Eiffel Tower built?"
}
],
"include_scores": true
}'Verification adds $1.00 per 1M completion tokens. See Reading the scores for what the numbers mean.
Which model?
GET /v1/models lists everything you can call, with its current price. If you
would rather not choose, Gallery picks for you, and Model
Select has the controls that shape the choice: a quality bar and an allowlist. The latency control is currently ignored.