Documentación de la API

Resumen de la API de RouterShift

RouterShift proporciona una API unificada compatible con OpenAI para acceder a cientos de modelos de IA de docenas de proveedores. Usa una sola clave API para enrutar solicitudes de forma inteligente entre proveedores con balanceo de carga, failover y optimización de costos integrados.

Características Principales

API compatible con OpenAI — reemplazo directo para cualquier cliente SDK de OpenAI
Enrutamiento inteligente con estrategias configurables (ponderado, round-robin, basado en latencia, failover)
Circuit breaker y limitación de tasa integrados para proteger tu aplicación
Caché semántica para reducir latencia y costos en consultas repetidas
Registro, monitoreo y análisis de gastos completos
Soporte multiproveedor con failover automático cuando un proveedor no está disponible

URL Base

Todas las solicitudes a la API usan la siguiente URL base. La API es totalmente compatible con las librerías cliente de OpenAI — solo cambia la URL base y usa tu clave API de RouterShift.

https://api.routershift.com/v1

docs.overview.anthropicBaseUrlTitle

docs.overview.anthropicBaseUrlDesc

docs.overview.anthropicBaseUrl

Compatibilidad con OpenAI

RouterShift es un reemplazo directo para la API de OpenAI. Si ya usas el SDK de OpenAI para Python o Node.js, puedes cambiar a RouterShift cambiando solo la URL base y la clave API. Todos los endpoints estándar — completaciones de chat, embeddings y listado de modelos — funcionan de manera idéntica.

Categorías de Modelos Soportados

RouterShift proporciona acceso a modelos de chat, generación de código, visión, generación de imágenes, razonamiento y audio de los principales proveedores de IA.

Obtener Ayuda

Si encuentras problemas o tienes preguntas, consulta las secciones a continuación para guías detalladas. Para consultas de facturación, contacta al soporte a través de la consola. Para actualizaciones de estado en tiempo real, visita la página de Estado.

Full Endpoint List

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

Method	Path	Descripción
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