Skip to main content

API Route Provider Guide

API Route is a Tier-2 catalog provider: OpenAI-wire-compatible with no behavioural quirks, so its entire integration is one JSON file (src/lib/providers/catalog/api-route.json) rather than hand-written code. That file is the source of truth for everything on this page.


Key Facts

  • Provider id: api-route (aliases: apiroute)
  • Protocol: OpenAI-compatible (/chat/completions)
  • Base URL: https://global.api-route.com/v1
  • Default model: claude-sonnet-4-6
  • Models in catalog: 8
  • Streaming: supported
  • Tool calling: supported (native)
  • Structured output: supported
  • Embeddings: not supported
  • Billing: free-tier

Quick Start

1. Get an API key

  1. Visit: https://api-route.com and create an account
  2. Generate an API key in your console / dashboard
  3. Set API_ROUTE_API_KEY in your .env file

2. Configure

export API_ROUTE_API_KEY=your-api-key
export API_ROUTE_MODEL=claude-sonnet-4-6 # optional — overrides the default model
export API_ROUTE_BASE_URL=https://global.api-route.com/v1 # optional — self-hosted or proxy

3. Use it

import { NeuroLink } from "@juspay/neurolink";

const neurolink = new NeuroLink();

const result = await neurolink.generate({
input: { text: "Explain context windows in one paragraph." },
provider: "api-route",
model: "claude-sonnet-4-6",
});

console.log(result.content);
# CLI
npx @juspay/neurolink generate "Hello" --provider api-route

Per-request credentials work as they do for every provider:

await neurolink.generate({
input: { text: "Hello" },
provider: "api-route",
credentials: { apiRoute: { apiKey: process.env.API_ROUTE_API_KEY } },
});

Models

ModelContextVision$/M in · outNotes
claude-sonnet-4-61MyesClaude Sonnet 4.6 — flagship model with 1M context, tool calling, and multimodal vision
claude-haiku-4-5195KyesClaude Haiku 4.5 — fast, high-efficiency model with 200K context, tool calling, and vision
deepseek-v4-flash1MnoDeepSeek V4 Flash — fast, cost-effective reasoning model with 1M context
deepseek-v4-pro1MnoDeepSeek V4 Pro — powerful reasoning model with 1M context
gemini-3.8-flash1MyesGemini 3.8 Flash — high-speed multimodal model supporting image input and streaming
qwen3.8-flash125KnoQwen 3.8 Flash — versatile, fast model for general instruction and coding tasks
kimi-k2.7-code250KnoKimi K2.7 Code — specialized for coding and multi-step reasoning
glm-5.3-flash125KnoGLM 5.3 Flash — lightweight, fast conversational and instruction-following model

Fallback order when the default is unavailable: claude-haiku-4-5deepseek-v4-flashgemini-3.8-flash.


Verification status

Tier-2 onboarding requires evidence before a provider is accepted, and pnpm run verify:provider-onboarding gates it in CI. This is what the catalog records for API Route:

ProbeResult
Rosterauthenticated GET /v1/models, HTTP 200, 2026-09-17
Auth rejectionHTTP 401, 2026-09-17
Live capability sweep2026-09-17 — Verified live against https://global.api-route.com/v1: GET /v1/models returned 70 models. Chat completions, streaming, function calling, streamed function calling, and structured JSON output (json_object and json_schema)

Troubleshooting

SymptomCauseFix
Invalid API Route API keyAPI_ROUTE_API_KEY unset or wrongCheck the key at https://api-route.com
Model not foundThe roster changed since 2026-09-17Pick a current id; catalog providers retire models without notice

See also