Backends

yaku soporta cuatro backends de traducción. Cada uno envía su texto a un proveedor de LLM diferente.

Backends disponibles

Backend	Modelo predeterminado	Notas
hosted	Del servidor	Predeterminado sin configuración. Prompts refinados por idioma.
gemini	gemini-2.5-flash	Clave API gratuita de Google AI Studio.
openai	gpt-4o-mini	Funciona con cualquier API compatible con OpenAI (Groq, Together, DeepSeek, Ollama).
anthropic	claude-haiku-4-5-20251001	Usa modelos Claude a través de la API de Mensajes de Anthropic.

Todos los backends usan una temperatura de 0.3 para traducciones consistentes y de baja variación. Con --verbose, yaku reporta la versión real del modelo usada por la API (que puede diferir del alias que especificó).

Cómo yaku elige un backend

El backend se resuelve en este orden:

1. Opción --backend — siempre gana si se especifica.
2. Campo backend en la configuración — se usa si no se pasa la opción.
3. Predeterminado — hosted. Tener una clave API no cambia el predeterminado. Debe elegir explícitamente un backend local.

# Sin configuración → usa hosted (el predeterminado)
yaku --to es "Hello"

# Clave API configurada, pero sin backend configurado → sigue usando hosted
yaku config set api-key AIza...
yaku --to es "Hello"

# Seleccionar explícitamente un backend local para usar su clave API
yaku config set backend gemini
yaku --to es "Hello"

# Sobrescribir por comando con la opción --backend
yaku --backend openai --to es "Hello"

Backend alojado

El backend predeterminado. Usa prompts refinados por idioma con mayor calidad de traducción que los backends locales. Consulte Servicio alojado y planes para una comparación, niveles de plan y límites de cuota.

# Usar el backend alojado (siempre el predeterminado)
yaku --to es "こんにちは"

Personalizar el endpoint alojado:

yaku config set hosted-url https://api.staging.yakulang.com

Backend Gemini

Usa la API de Gemini de Google. Obtenga una clave API gratuita de Google AI Studio. yaku desactiva el modo de razonamiento de Gemini para reducir la latencia y el costo de tokens — la traducción es seguimiento de instrucciones, no una tarea de razonamiento.

# Configurar
yaku config set api-key SU_CLAVE_API_GEMINI

# O usar variable de entorno
export GOOGLE_API_KEY=SU_CLAVE_API_GEMINI

Sobrescribir el modelo:

yaku --model gemini-2.5-pro --to es "Hello"

Backend OpenAI

Funciona con la API de OpenAI y cualquier proveedor compatible con OpenAI.

# OpenAI
yaku config set backend openai
yaku config set api-key SU_CLAVE_API_OPENAI

# O usar variable de entorno
export OPENAI_API_KEY=SU_CLAVE_API_OPENAI
yaku --backend openai --to es "Hello"

Proveedores compatibles con OpenAI

Use --api-base para apuntar a cualquier endpoint compatible:

# Groq
yaku --backend openai \
  --api-base https://api.groq.com/openai/v1 \
  --model llama-3.3-70b-versatile \
  --to es "Hello"

# Together.ai
yaku --backend openai \
  --api-base https://api.together.xyz/v1 \
  --model meta-llama/Llama-3-70b-chat-hf \
  --to es "Hello"

# Ollama local
yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to es "Hello"

# DeepSeek
yaku --backend openai \
  --api-base https://api.deepseek.com/v1 \
  --model deepseek-chat \
  --to es "Hello"

Guardar como valores predeterminados para no repetir opciones:

yaku config set backend openai
yaku config set api-base https://api.groq.com/openai/v1
yaku config set model llama-3.3-70b-versatile
yaku config set api-key SU_CLAVE_API_GROQ

Backend Anthropic

Usa modelos Claude a través de la API de Mensajes de Anthropic.

yaku config set backend anthropic
yaku config set api-key SU_CLAVE_API_ANTHROPIC

# O usar variable de entorno
export ANTHROPIC_API_KEY=SU_CLAVE_API_ANTHROPIC
yaku --backend anthropic --to es "Hello"

Sobrescribir el modelo:

yaku --backend anthropic --model claude-sonnet-4-5-20250514 --to es "Hello"

Cambiar entre backends

La opción --backend sobrescribe su backend configurado para un solo comando. Cada backend local requiere su propia clave API — yaku verifica automáticamente la variable de entorno específica del proveedor (GOOGLE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY) cuando no hay api-key configurada y YAKU_API_KEY no está definida.

Configure todas sus claves una vez y cambie libremente:

export GOOGLE_API_KEY=su-clave-gemini
export OPENAI_API_KEY=su-clave-openai
export ANTHROPIC_API_KEY=su-clave-anthropic

# Comparar salidas de diferentes backends
echo "Hello" | yaku --backend gemini --to es
echo "Hello" | yaku --backend openai --to es
echo "Hello" | yaku --backend anthropic --to es
echo "Hello" | yaku --backend hosted --to es

El backend hosted nunca necesita una clave API.

Nota

Si tiene api-key configurada (o YAKU_API_KEY en su entorno), las variables específicas del proveedor se ignoran — yaku usa la clave configurada para todos los backends. Para usar la búsqueda alternativa por proveedor, deje api-key sin configurar.

Consejo

Para uso diario, elija un backend local y configúrelo como predeterminado. Use --backend hosted cuando quiera la calidad de traducción refinada sin configuración de claves.

yaku config set backend gemini
yaku config set api-key SU_CLAVE_GEMINI

# Uso normal → Gemini
yaku --to es "Hello"

# Comparación rápida → hosted (sin clave necesaria)
yaku --backend hosted --to es "Hello"