RouterShiftRouterShift
Explorar ModelosPreciosDocumentación
RouterShiftRouterShiftRouterShift. Infraestructura de IA Empresarial.
Explorar ModelosEstadoDocumentaciónTérminosPrivacidadDPATransparencia

Documentación de la API

Referencia de API

Resumen de la API de RouterShift

RouterShift ofrece interfaces compatibles con OpenAI, Anthropic y Gemini para los modelos activos para tu clave. Routing, failover, facturación y evidencia de auditoría se aplican tras el límite de protocolo.

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

Base URL compatible con Anthropic

Para el SDK de Anthropic o Claude Code. Nota: sin sufijo /v1 — el SDK añade /v1/messages automáticamente.

https://api.routershift.com

Compatibilidad con OpenAI

Los clientes OpenAI, Anthropic y Gemini suelen conectarse cambiando URL base y credencial. Los campos y rutas admitidos los define el contrato OpenAPI actual; las extensiones upstream no son automáticamente portables.

Categorías de Modelos Soportados

GET /v1/models es la autoridad para los modelos disponibles para tu clave. La disponibilidad también depende de producto, salud de ruta, permisos, saldo, región y acceso privado.

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.

Lista completa de endpoints

La tabla es un índice legible del plano de datos público. Usa /api/openapi.yaml como contrato de máquina y /api/docs como referencia interactiva; siguen aplicando los alcances de clave.

GET/v1/version

Versión y compatibilidad de la API de datos

GET/v1/models

Listado de modelos

POST/v1/chat/completions

Completado de chat (compatible con OpenAI)

POST/v1/messages

API de mensajes (compatible con Anthropic)

POST/v1/models/gemini/:model/generateContent

Generación de contenido de Gemini

POST/v1/models/gemini/:model/streamGenerateContent

Generación de contenido en streaming de Gemini

POST/v1/embeddings

Embeddings de texto

POST/v1/rerank

Reordenación

POST/v1/chat/completions/estimate

Estimación previa de tokens y coste

POST/v1/images/generations

Generación de imágenes

POST/v1/audio/transcriptions

Transcripción de audio

POST/v1/audio/speech

Texto a voz

POST/v1/tts

Texto a voz extendido

POST/v1/transcriptions

Transcripción extendida

POST/v1/midjourney/imagine

Generación de imágenes Midjourney

POST/v1/suno/generate

Generación de música Suno

POST/v1/video/generations

Tarea de generación de video

GET/v1/video/tasks/:task_id

Estado de la tarea de vídeo

POST/v1/chat/completions/async

Tarea asíncrona — Enviar

GET/v1/chat/completions/async/:task_id

Tarea asíncrona — Verificar estado

GET/v1/chat/completions/async/:task_id/result

Tarea asíncrona — Obtener resultado

POST/v1/batch

Procesamiento por lotes

GET/v1/batch/:batch_id

Estado del trabajo por lotes

GET/v1/batch/:batch_id/results

Descarga de resultados por lotes

POST/v1/batch/:batch_id/cancel

Cancelar trabajo por lotes

POST/v1/mcp/

Pasarela de herramientas MCP JSON-RPC

GET/v1/mcp/sse

Transporte SSE de MCP

POST/v1/a2a/

Pasarela JSON-RPC A2A

GET/v1/a2a/sse

Flujo de eventos SSE de A2A

MétodoRutaDescripción
GET/v1/versionVersión y compatibilidad de la API de datos
GET/v1/modelsListado de modelos
POST/v1/chat/completionsCompletado de chat (compatible con OpenAI)
POST/v1/messagesAPI de mensajes (compatible con Anthropic)
POST/v1/models/gemini/:model/generateContentGeneración de contenido de Gemini
POST/v1/models/gemini/:model/streamGenerateContentGeneración de contenido en streaming de Gemini
POST/v1/embeddingsEmbeddings de texto
POST/v1/rerankReordenación
POST/v1/chat/completions/estimateEstimación previa de tokens y coste
POST/v1/images/generationsGeneración de imágenes
POST/v1/audio/transcriptionsTranscripción de audio
POST/v1/audio/speechTexto a voz
POST/v1/ttsTexto a voz extendido
POST/v1/transcriptionsTranscripción extendida
POST/v1/midjourney/imagineGeneración de imágenes Midjourney
POST/v1/suno/generateGeneración de música Suno
POST/v1/video/generationsTarea de generación de video
GET/v1/video/tasks/:task_idEstado de la tarea de vídeo
POST/v1/chat/completions/asyncTarea asíncrona — Enviar
GET/v1/chat/completions/async/:task_idTarea asíncrona — Verificar estado
GET/v1/chat/completions/async/:task_id/resultTarea asíncrona — Obtener resultado
POST/v1/batchProcesamiento por lotes
GET/v1/batch/:batch_idEstado del trabajo por lotes
GET/v1/batch/:batch_id/resultsDescarga de resultados por lotes
POST/v1/batch/:batch_id/cancelCancelar trabajo por lotes
POST/v1/mcp/Pasarela de herramientas MCP JSON-RPC
GET/v1/mcp/sseTransporte SSE de MCP
POST/v1/a2a/Pasarela JSON-RPC A2A
GET/v1/a2a/sseFlujo de eventos SSE de A2A

Correspondencia de protocolos

RouterShift es compatible con múltiples protocolos API. La siguiente tabla muestra la base URL y la configuración del SDK para cada uno.

Compatible con OpenAI

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer / x-api-key

Compatible con 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 baseEjemplo de parámetro de modeloEncabezado de autenticación
https://api.routershift.com/v1
SDK estándar de OpenAI — solo cambia base_url
<available-model-code>Authorization: Bearer / x-api-key
https://api.routershift.com
SDK estándar de Anthropic — solo cambia base_url
<available-model-code>x-api-key: sk-xxx
https://api.routershift.com/v1
Formato nativo de Gemini, llama a generateContent directamente
<available-model-code>Authorization: Bearer

Autenticación unificada

Todos los endpoints usan la misma autenticación. Ambos formatos de encabezado funcionan de manera idéntica:

Formato compatible con OpenAI

Authorization: Bearer sk-xxx

Formato compatible con Anthropic

x-api-key: sk-xxx