O RouterShift oferece interfaces compatíveis com OpenAI, Anthropic e Gemini para os modelos ativos para sua chave. Roteamento, failover, cobrança e evidência de auditoria são aplicados após a fronteira de protocolo.
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/v1Para o SDK da Anthropic ou o Claude Code. Observação: não use o sufixo /v1 — o SDK adiciona /v1/messages automaticamente.
https://api.routershift.comClientes OpenAI, Anthropic e Gemini normalmente conectam alterando URL base e credencial. Campos e rotas são definidos pelo contrato OpenAPI atual; extensões upstream não são automaticamente portáveis.
GET /v1/models é a autoridade para os modelos disponíveis à sua chave. A disponibilidade também depende de produto, saúde da rota, permissões, saldo, região e acesso privado.
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.
A tabela é um índice legível do plano de dados público. Use /api/openapi.yaml como contrato de máquina e /api/docs como referência interativa; os escopos da chave continuam valendo.
/v1/versionVersão e compatibilidade da API de dados
/v1/modelsLista de modelos
/v1/chat/completionsCompletions de Chat (compatível com OpenAI)
/v1/messagesAPI de mensagens (compatível com Anthropic)
/v1/models/gemini/:model/generateContentGeração de conteúdo do Gemini
/v1/models/gemini/:model/streamGenerateContentGemini Stream Gerar Conteúdo
/v1/embeddingsEmbeddings de texto
/v1/rerankReclassificação
/v1/chat/completions/estimateEstimativa prévia de tokens e custo
/v1/images/generationsGeração de imagens
/v1/audio/transcriptionsTranscrição de áudio
/v1/audio/speechTexto para Fala
/v1/ttsTexto para fala estendido
/v1/transcriptionsTranscrição estendida
/v1/midjourney/imagineGeração de imagens com Midjourney
/v1/suno/generateGeração de Música Suno
/v1/video/generationsTarefa de geração de vídeo
/v1/video/tasks/:task_idEstado da tarefa de vídeo
/v1/chat/completions/asyncTarefa assíncrona — enviar
/v1/chat/completions/async/:task_idTarefa Assíncrona — Verificar Status
/v1/chat/completions/async/:task_id/resultTarefa assíncrona — obter resultado
/v1/batchProcessamento em Lote
/v1/batch/:batch_idEstado do trabalho em lote
/v1/batch/:batch_id/resultsDownload dos resultados em lote
/v1/batch/:batch_id/cancelCancelar trabalho em lote
/v1/mcp/Gateway de ferramentas MCP JSON-RPC
/v1/mcp/sseTransporte SSE do MCP
/v1/a2a/Gateway JSON-RPC A2A
/v1/a2a/sseFluxo de eventos SSE do A2A
| Método | Caminho | Descrição |
|---|---|---|
| GET | /v1/version | Versão e compatibilidade da API de dados |
| GET | /v1/models | Lista de modelos |
| POST | /v1/chat/completions | Completions de Chat (compatível com OpenAI) |
| POST | /v1/messages | API de mensagens (compatível com Anthropic) |
| POST | /v1/models/gemini/:model/generateContent | Geração de conteúdo do Gemini |
| POST | /v1/models/gemini/:model/streamGenerateContent | Gemini Stream Gerar Conteúdo |
| POST | /v1/embeddings | Embeddings de texto |
| POST | /v1/rerank | Reclassificação |
| POST | /v1/chat/completions/estimate | Estimativa prévia de tokens e custo |
| POST | /v1/images/generations | Geração de imagens |
| POST | /v1/audio/transcriptions | Transcrição de áudio |
| POST | /v1/audio/speech | Texto para Fala |
| POST | /v1/tts | Texto para fala estendido |
| POST | /v1/transcriptions | Transcrição estendida |
| POST | /v1/midjourney/imagine | Geração de imagens com Midjourney |
| POST | /v1/suno/generate | Geração de Música Suno |
| POST | /v1/video/generations | Tarefa de geração de vídeo |
| GET | /v1/video/tasks/:task_id | Estado da tarefa de vídeo |
| POST | /v1/chat/completions/async | Tarefa assíncrona — enviar |
| GET | /v1/chat/completions/async/:task_id | Tarefa Assíncrona — Verificar Status |
| GET | /v1/chat/completions/async/:task_id/result | Tarefa assíncrona — obter resultado |
| POST | /v1/batch | Processamento em Lote |
| GET | /v1/batch/:batch_id | Estado do trabalho em lote |
| GET | /v1/batch/:batch_id/results | Download dos resultados em lote |
| POST | /v1/batch/:batch_id/cancel | Cancelar trabalho em lote |
| POST | /v1/mcp/ | Gateway de ferramentas MCP JSON-RPC |
| GET | /v1/mcp/sse | Transporte SSE do MCP |
| POST | /v1/a2a/ | Gateway JSON-RPC A2A |
| GET | /v1/a2a/sse | Fluxo de eventos SSE do A2A |
O RouterShift é compatível com vários protocolos de API. A tabela abaixo mostra a URL base e a configuração do SDK para cada um.
Compatível com OpenAI
https://api.routershift.com/v1
Models: <available-model-code>
Authorization: Bearer / x-api-key
Compatível com Anthropic
https://api.routershift.com
Models: <available-model-code>
x-api-key: sk-xxx
Gemini Nativo
https://api.routershift.com/v1
Models: <available-model-code>
Authorization: Bearer
| URL Base | Exemplo de parâmetro de modelo | Header de Autenticação |
|---|---|---|
https://api.routershift.com/v1 SDK padrão da OpenAI — basta alterar base_url | <available-model-code> | Authorization: Bearer / x-api-key |
https://api.routershift.com SDK padrão da Anthropic — basta alterar base_url | <available-model-code> | x-api-key: sk-xxx |
https://api.routershift.com/v1 Formato nativo Gemini, chame generateContent diretamente | <available-model-code> | Authorization: Bearer |
Todos os endpoints usam a mesma autenticação. Os dois formatos de cabeçalho funcionam da mesma forma:
Formato compatível com OpenAI
Authorization: Bearer sk-xxxFormato compatível com Anthropic
x-api-key: sk-xxx