Guías de construcción
Migra desde el SDK de OpenAI con una línea de configuración
Los cambios mínimos para conectar un cliente compatible con OpenAI a EasyAI.
Qué aprenderás
- Keep the SDK and isolate provider settings in environment variables.
- Make the model name configurable so switching is reversible.
- Validate streaming, errors, usage, and latency in staging.
Antes de empezar
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
Conclusiones clave
- Conserva el SDK y aísla la configuración en variables de entorno.
- Haz configurable el modelo para poder revertir.
- Valida streaming, errores, uso y latencia en staging.
Conserva tu cliente
EasyAI acepta el formato compatible con OpenAI. Normalmente solo debes cambiar la base URL, usar una API key de EasyAI y elegir un modelo habilitado.
Tu código de streaming, timeouts y manejo de errores puede seguir igual.
Cambia la configuración, no la lógica
Guarda la URL y la clave en variables de entorno del servidor. Haz que el nombre del modelo sea configurable para comparar opciones sin cambiar el código.
Para imagen y video, usa el endpoint documentado y contempla operaciones más largas o asíncronas.
Verifica antes de producción
Empieza con Quickstart, confirma la respuesta y mide latencia y uso en staging. Revisa el soporte de endpoints y precios actuales antes de mover tráfico.
Centraliza la configuración para que un rollback sea un cambio de variable de despliegue.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Crea una API key de EasyAI.
- 2
Configura la base URL en el servidor.
- 3
Cambia el modelo y ejecuta Quickstart.
- 4
Mueve tráfico gradualmente y conserva la configuración anterior.
Ejemplo para copiar
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.EASYAI_API_KEY,
baseURL: "https://easyairoute.com/v1",
});
const completion = await client.chat.completions.create({
model: process.env.EASYAI_MODEL ?? "deepseek-chat",
messages: [{ role: "user", content: "Hello" }],
});Preguntas frecuentes
¿Necesito otro SDK?
Normalmente no; el formato es compatible con OpenAI.
¿Dónde guardo la API key?
Solo en el servidor o en un gestor de secretos, nunca en el navegador.
Fuentes
- OpenAI API referenceFuente verificada 2026-08-27