Documentação da API

Visão Geral da API RouterShift

RouterShift fornece uma API unificada compatível com OpenAI para acessar centenas de modelos de IA de dezenas de provedores. Use uma única chave API para rotear requisições de forma inteligente entre provedores com balanceamento de carga integrado, failover e otimização de custos.

Principais Funcionalidades

API compatível com OpenAI — substituição direta para qualquer cliente SDK OpenAI
Roteamento inteligente com estratégias configuráveis (ponderado, round-robin, baseado em latência, failover)
Disjuntor integrado e limitação de taxa para proteger sua aplicação
Cache semântico para reduzir latência e custos em consultas repetidas
Registro abrangente, monitoramento e análise de gastos
Suporte a múltiplos provedores com failover automático quando um provedor está indisponível

URL Base

Todas as requisições da API usam a seguinte URL base. A API é totalmente compatível com as bibliotecas cliente OpenAI — basta alterar a URL base e usar sua chave API RouterShift.

https://api.routershift.com/v1

docs.overview.anthropicBaseUrlTitle

docs.overview.anthropicBaseUrlDesc

docs.overview.anthropicBaseUrl

Compatibilidade com OpenAI

RouterShift é uma substituição direta para a API OpenAI. Se você já usa o SDK Python ou Node.js da OpenAI, pode migrar para o RouterShift alterando apenas a URL base e a chave API. Todos os endpoints padrão — chat completions, embeddings e listagem de modelos — funcionam de forma idêntica.

Categorias de Modelos Suportados

RouterShift fornece acesso a modelos de chat, geração de código, visão, geração de imagens, raciocínio e áudio dos principais provedores de IA.

Obtendo Ajuda

Se você encontrar problemas ou tiver dúvidas, consulte as seções abaixo para guias detalhados. Para consultas de cobrança, entre em contato com o suporte através do console. Para atualizações de status em tempo real, visite a página de Status.

Full Endpoint List

All API endpoints share a single base URL and authentication method. One API key works across every endpoint.

Method	Path	Descrição
POST	/v1/chat/completions	Chat Completions (OpenAI-compatible)
POST	/v1/messages	Messages API (Anthropic-compatible)
POST	/v1/models/gemini/:model/generateContent	Gemini Generate Content
POST	/v1/models/gemini/:model/streamGenerateContent	Gemini Stream Generate Content
POST	/v1/embeddings	Text Embeddings
POST	/v1/images/generations	Image Generation
POST	/v1/audio/transcriptions	Audio Transcription
POST	/v1/audio/speech	Text to Speech
POST	/v1/rerank	Rerank
POST	/v1/midjourney/imagine	Midjourney Image Generation
POST	/v1/suno/generate	Suno Music Generation
POST	/v1/batch	Batch Processing
POST	/v1/chat/completions/async	Async Task — Submit
GET	/v1/chat/completions/async/:id	Async Task — Check Status
GET	/v1/chat/completions/async/:id/result	Async Task — Get Result
GET	/v1/models	Model Listing

Protocol Correspondence

RouterShift is compatible with multiple API protocols. The table below shows the base URL and SDK configuration for each.

Base URL	Example Model Parameter	Auth Header
https://api.routershift.com/v1 Standard OpenAI SDK — just change base_url	gpt-4o, claude-sonnet-4-6	Authorization: Bearer
docs.overview.anthropicBaseUrl Standard Anthropic SDK — just change base_url	claude-sonnet-4-6	x-api-key: sk-xxx
docs.overview.googleBaseUrl Gemini native format, call generateContent directly	gemini-2.5-flash	Authorization: Bearer

Unified Authentication

All endpoints use the same authentication. Both header formats work identically:

OpenAI-compatible format

Authorization: Bearer sk-xxx

Anthropic-compatible format

x-api-key: sk-xxx