Skip to content

XiuRouter API documentation

Connect applications and coding agents to GPT, Claude, Gemini, and other models through one XiuRouter API key.

Updated Reviewed
View Markdown

XiuRouter is a model API service for developers. Use one account and scoped API keys to call models through OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, or Gemini GenerateContent.

Send your first request

Create a scoped API key, list available models, and make a small text request. Start the quickstart

Choose the right protocol

Match your client to the correct base URL, authentication method, and endpoint. Review API compatibility

Connect Codex

Add a Responses provider to ChatGPT desktop, Codex CLI, or the Codex IDE extension. Configure Codex

Connect Claude Code or Cursor

Use the Messages gateway for Claude Code or the OpenAI base URL override for Cursor. Configure Claude Code

Use the correct address

Purpose Address Use it for
Console https://router.xiu.ai Sign in, add funds, create API keys, view pricing, and inspect usage
OpenAI-compatible base URL https://router-api.xiu.ai/v1 Chat Completions, Responses, and clients that expect an OpenAI-style base URL
Anthropic or Gemini API root https://router-api.xiu.ai Clients that append /v1/messages or /v1beta/models/... themselves

Do not use the console domain as the base URL for a new integration. The direct API domain avoids the extra console edge proxy and is the supported path for long streaming requests.

Start from your use case

  1. New API integration: complete the XiuRouter quickstart.
  2. Existing OpenAI-compatible app: replace the base URL and API key, then confirm the exact model ID still exists.
  3. Codex: use a custom provider with wire_api = "responses".
  4. Claude Code: use the API root without /v1; Claude Code appends /v1/messages.
  5. Cursor: enable its OpenAI base URL override and test Ask before Agent.

Current boundaries

  • Model availability, service groups, and prices change. Read the current models and pricing page before deployment.
  • A route can exist while a specific model or service group does not support every field on that route.
  • A model that works through Chat Completions does not automatically work through Responses or Messages.
  • Changing the base URL does not transfer hosted tools, client subscriptions, or cloud features from the model vendor.
  • Use a small request with the intended model, service group, and protocol before sending production traffic.
  • Never put an API key in source control, screenshots, shared configuration, or support messages.

Sources and review date

This page was checked against the current XiuRouter console, public status response, model catalogue, and product integration definitions on August 22, 2026. Model and client behavior can change; verify the live catalogue and the client vendor’s current documentation when you connect.

Navigation

Enter keywords to search

↑↓ Move↵ OpenEsc Close