OpenCode AI Gateway: Conecta múltiples LLMs a través de una API

Un gateway de OpenCode AI te proporciona una capa de API estable entre tu flujo de trabajo terminal y los modelos que realmente deseas usar. Si estás manejando claves de proveedores separados, páginas de facturación separadas y riesgos de disponibilidad separados, esa capa adicional puede hacer que OpenCode sea mucho más fácil de operar día a día.

ShareAI encaja bien en ese rol porque te ofrece una API para más de 150 modelos, además de enrutamiento inteligente, conmutación por error y visibilidad en el mercado. OpenCode ya admite proveedores personalizados compatibles con OpenAI, por lo que la configuración se trata principalmente de apuntar OpenCode a la URL base correcta y agregar el modelo que deseas usar.

Esta guía es parte de nuestra Desarrolladores artículos sobre enrutamiento de IA, acceso a modelos e integraciones listas para producción.

¿Por qué usar un gateway de OpenCode AI en primer lugar?

OpenCode está diseñado para trabajar con muchos proveedores, y su documentación pública muestra soporte para configuración de proveedores personalizados, valores de baseURL y endpoints compatibles con OpenAI. Esa flexibilidad es poderosa, pero también significa que puedes terminar gestionando cada proveedor por separado cuando todo lo que realmente deseas es un flujo de trabajo de codificación limpio.

• Una clave de API en lugar de una clave por proveedor de modelos.
• Una superficie de facturación en lugar de varios paneles de control.
• Cambios más limpios entre modelos para ediciones rápidas, tareas de contexto largo o refactorizaciones más pesadas.
• Una capa de enrutamiento que puede ayudar cuando un proveedor es lento, no está disponible o ya no es el más adecuado para el trabajo.

Para los desarrolladores que desean flexibilidad sin mantener la infraestructura separada de proveedores, ese suele ser el punto en el que un gateway de IA comienza a justificar su costo.

Cómo OpenCode admite esta configuración

Según la documentación oficial de proveedores de OpenCode, puedes personalizar la configuración del proveedor a través de opencode.json, establecer un personalizado valores de baseURL, y usar @ai-sdk/openai-compatible para proveedores compatibles con OpenAI. El público repositorio de GitHub de OpenCode también documenta sus rutas de configuración y confirma que la herramienta está diseñada para flexibilidad a nivel de proveedor.

Eso significa que no necesitas un paquete de integración especial de ShareAI para comenzar. Puedes agregar ShareAI como un proveedor personalizado, mantener tu clave API en una variable de entorno y luego elegir el modelo exacto que deseas que OpenCode llame.

Paso 1: Crea tu clave API de ShareAI y elige un modelo

Comienza generando credenciales en Crear una clave API. Luego navega por el mercado de modelos de ShareAI para decidir qué modelo debería respaldar tu flujo de trabajo de OpenCode.

Un patrón práctico es elegir un modelo predeterminado para tareas de codificación diarias y tener en mente una o dos alternativas para casos en los que desees menor latencia, menor costo o un modelo de razonamiento más fuerte.

Paso 2: Agrega ShareAI como un proveedor personalizado en opencode.json

OpenCode te permite definir un proveedor personalizado con un endpoint compatible con OpenAI. Una plantilla inicial simple se ve así:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

Reemplazar tu-modelo-shareai con el identificador exacto del modelo que deseas usar del catálogo de modelos de ShareAI. Mantén la clave API fuera del archivo y cárgala a través de una variable de entorno.

export SHAREAI_API_KEY="tu_clave_api_aquí"

Si deseas el formato de solicitud más amplio y los detalles de autenticación, el Referencia de API cubre el flujo principal de la API de ShareAI.

Paso 3: Cambia modelos sin reconstruir tu configuración

Una vez que ShareAI es la capa de proveedor, los cambios de modelo se vuelven mucho más ligeros. Ya no estás rehaciendo la autenticación del proveedor cada vez que deseas probar un modelo diferente. En su lugar, mantienes la misma superficie de API y cambias el modelo al que apunta OpenCode.

Eso es especialmente útil cuando tu flujo de trabajo de codificación cambia según la tarea. Podrías querer un modelo para ediciones rápidas, otro para razonamiento en repositorios más grandes, y un tercero como respaldo cuando el costo o la latencia importan más que la capacidad máxima. Puedes comparar opciones en el mercado de modelos y verificar el comportamiento en el Área de pruebas antes de establecer un valor predeterminado.

Cuando las claves directas del proveedor aún tienen sentido

Todavía hay casos en los que ir directo es razonable. Si dependes de una función beta específica del proveedor, un acuerdo empresarial privado, o una configuración estricta de gobernanza dentro del proveedor, podrías querer mantener ese camino separado.

Pero para los equipos que principalmente quieren que OpenCode sea flexible, portátil y más fácil de operar, usar un gateway de OpenCode AI suele ser la opción predeterminada más limpia. Reduce la proliferación de cuentas y te permite evaluar modelos en función de su rendimiento y adecuación en lugar de en qué inicio de sesión de proveedor configuraste por última vez.

Conclusión final

Un gateway de OpenCode AI no se trata de añadir más herramientas por el simple hecho de hacerlo. Se trata de mantener un flujo de trabajo de codificación mientras te das espacio para cambiar modelos, comparar proveedores y seguir avanzando cuando el panorama de modelos subyacente cambia. Si eso es lo que deseas de OpenCode, ShareAI te ofrece una forma práctica de hacerlo a través de una API.