Proveedores de LLM
Cada pipeline de traducción —translate-ui, translate-docs, translate-json y translate-svg— envía texto a un LLM a través del mismo cliente independiente del proveedor. Antes de que cualquiera de esos comandos pueda ejecutarse, configure al menos un proveedor en ai-i18n-tools.config.json y establezca la clave API correspondiente en su entorno o .env (ajustes preestablecidos integrados excepto Ollama). init escribe un bloque inicial provider / providers; aún debe proporcionar credenciales para el ajuste preestablecido activo.
Configuras qué punto de conexión de la API llamar una vez en la configuración; todos los comandos de traducción comparten esa configuración y la misma caché de SQLite. Qué modelos intenta ese proveedor es un paso aparte: Modelos de IA.
La CLI resuelve el proveedor activo a partir de la clave provider de nivel superior (o la única entrada en providers cuando solo hay uno configurado). Cada bloque de proveedor enumera una cadena de reserva translationModels ordenada; los ajustes preestablecidos incorporados heredan baseUrl y la variable de entorno de clave de API automáticamente (anúlelos por proveedor cuando sea necesario).
Proveedores integrados
Las claves de proveedor preestablecidas solo necesitan translationModels: la URL base y la variable de entorno de la clave de API se rellenan automáticamente:
| Proveedor | Variable de entorno de clave API | URL base |
|---|---|---|
alibaba | ALIBABA_API_KEY | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
anthropic | ANTHROPIC_API_KEY | https://api.anthropic.com/v1 |
apikeyfan | APIKEYFAN_API_KEY | https://api.apikey.fan/v1 |
cerebras | CEREBRAS_API_KEY | https://api.cerebras.ai/v1 |
cheaperinference | CHEAPERINFERENCE_API_KEY | https://api.cheaperinference.com/v1 |
deepseek | DEEPSEEK_API_KEY | https://api.deepseek.com |
gemini | GOOGLE_API_KEY | https://generativelanguage.googleapis.com/v1beta/openai |
groq | GROQ_API_KEY | https://api.groq.com/openai/v1 |
mistral | MISTRAL_API_KEY | https://api.mistral.ai/v1 |
nvidia | NVIDIA_API_KEY | https://integrate.api.nvidia.com/v1 |
ollama | (none) | http://localhost:11434/v1 |
openai | OPENAI_API_KEY | https://api.openai.com/v1 |
openrouter | OPENROUTER_API_KEY | https://openrouter.ai/api/v1 |
xai | XAI_API_KEY | https://api.x.ai/v1 |
Para cualquier clave no preestablecida, configure baseUrl y apiKeyEnv explícitamente en la configuración.
Establezca la clave de API del proveedor activo en su entorno, o en .env / .env.local junto a ai-i18n-tools.config.json cuando no se haya configurado ya ninguna clave de API del proveedor. La CLI imprime los nombres de las variables que leyó de esos archivos. Consulte Variables de entorno.
Sin retención de datos (inferencia más económica)
providers.cheaperinference.zeroDataRetention es opcional y está desactivado por defecto. Actívalo cuando este proyecto deba enviar las indicaciones solo a través de proveedores que no las conserven.
"cheaperinference": {
"zeroDataRetention": true,
"translationModels": ["gemini-2.5-flash", "deepseek-v4-flash"]
}Con el indicador activado, cada solicitud de chat incluye "zdr": true, y list-models, check-models y suggest-models (incluida la pestaña Modelos del panel) muestran GET /v1/models?zdr=true. Ese catálogo enumera los modelos que una solicitud de cero retención de datos puede usar, al precio de cero retención de datos. check-models considera un ID que falta en ese catálogo como no válido. El indicador no crea una ruta para un modelo que el catálogo omite. Elimine ese ID de translationModels, uiModels o localeModels.
Deja la opción desactivada cuando la cuenta de Inferencia más económica no requiera retención de datos cero. Si la Protección de datos ya está activada para la cuenta, Inferencia más económica sigue rechazando un modelo sin una ruta de retención de datos cero. El error nombra a ese modelo. Para mantener la política de la cuenta, establece zeroDataRetention en true y cambia a un modelo del catálogo de retención de datos cero. Para mantener el modelo rechazado, desactiva la retención de datos cero en esa página. La cadena de reserva intenta entonces el siguiente modelo configurado.
Modelos
La elección de modelos, la lista de respaldo y suggest-models, check-models, list-models y bench-models están en Modelos de IA.
Múltiples proveedores
Cuando se configura más de un proveedor, establezca la clave provider de nivel superior para seleccionar el predeterminado. Cambie por ejecución sin editar la configuración:
npx ai-i18n-tools translate-docs -P anthropic
npx ai-i18n-tools bench-models -P deepseekCada bloque de proveedor puede definir su propio translationModels, uiModels y localeModels opcionales, maxTokens, temperature y requestTimeout (segundos) o requestTimeoutMs. Un tiempo de espera en el proveedor anula el requestTimeout / requestTimeoutMs de nivel superior. Un bloque openrouter de nivel superior heredado todavía se acepta y se migra automáticamente a providers.openrouter al cargarse.
Los pricing y modelPricing opcionales establecen el USD por cada millón de tokens (inputPerMTokens y outputPerMTokens) cuando el proveedor omite usage.cost. pricing es el valor predeterminado a nivel de proveedor; una entrada modelPricing lo anula para un ID de modelo. OpenRouter y Cheaper Inference ya devuelven un costo por llamada, así que déjelos sin establecer en esos proveedores. Un costo informado por el proveedor se mantiene tal como se devuelve. El monto se incluye en el resumen de traducción, usage, y Uso y costos.
Ejemplo ejecutable con cuatro proveedores en el mismo documento, incluyendo tarifas de ejemplo: examples/multi-provider.
Referencia adicional
- Modelos de IA: lista de preselección clasificada, lista de respaldo y los comandos del modelo.
- Configuración —
provideryproviders: tabla preestablecida, puntos de conexión personalizados, tiempos de espera de la solicitud, tarifas de coste, retención de datos cero de Cheaper Inference, comportamiento específico de OpenRouter. - Arquitectura — Cliente LLM: cómo funcionan internamente el respaldo de modelos, el procesamiento por lotes y los informes de costes.
- Variables de entorno: variables de entorno de clave de API y anulaciones de la URL base.