Conectar la IA
El provider es quién le pregunta a Jev. TypeSafe directo, Vercel AI Gateway, o el que lean las variables de entorno.
EDcheck no llama a la IA “a ciegas”. Tú le pasas un provider a createEDcheck. Ese objeto sabe a qué API pegarle.
Cuál usar
| Provider | Cuándo | Auth |
|---|---|---|
typesafeProvider | La ruta más simple. No instalas nada extra. | TYPESAFE_API_KEY |
gatewayProvider | Si ya facturas con Vercel AI Gateway. | AI_GATEWAY_API_KEY o OIDC de Vercel |
providerFromEnv | Que elija solo según las variables de entorno. | Lee las dos de arriba |
TypeSafe directo
import { createEDcheck, typesafeProvider } from "@edteam/edcheck"; const edcheck = createEDcheck({ provider: typesafeProvider({ apiKey: process.env.TYPESAFE_API_KEY!, }),});Opcional: model (por defecto jev-latest), baseUrl, retries y retryDelayMs.
Vercel AI Gateway
Esta ruta usa paquetes extra. Instálalos solo si vas por Gateway:
yarn add ai @ai-sdk/gatewayimport { createEDcheck, gatewayProvider } from "@edteam/edcheck"; const edcheck = createEDcheck({ provider: gatewayProvider(),});En Vercel puedes no pasar apiKey. Gateway usa OIDC. En local, pon AI_GATEWAY_API_KEY.
Que lo elija el entorno
import { createEDcheck, providerFromEnv } from "@edteam/edcheck"; const edcheck = createEDcheck({ provider: providerFromEnv(),});Por defecto, si las dos keys existen, gana TypeSafe. Así no dependes de los paquetes de Gateway. Puedes cambiarlo con prefer: "gateway".
Si no hay ninguna key (un string vacío cuenta como “no hay”), lanza EDcheckConfigError con el código missing_api_key.
Para tests no uses estos providers. Usa mockProvider, que está en la siguiente página de “Probar sin internet”.