Saltar al contenido principal

​
Cómo funciona Synthetic

Synthetic es un servicio de suscripción que ejecuta LLMs de código abierto para codificación en infraestructura dedicada y los sirve a través de una API compatible con OpenAI (y compatible con Anthropic). En lugar de pagar por token, pagas una suscripción mensual fija y obtienes un generoso presupuesto de límite de tasa que cubre cada modelo en la plataforma. Está posicionado como una alternativa directa a los planes de 20/mesy20/mes y 200/mes de Claude para desarrolladores que hacen mucha codificación: el mismo precio, límites de tasa varias veces mayores y tu elección de modelos de código abierto. Kodus llega a Synthetic a través del endpoint compatible con OpenAI, por lo que no hay cambios de adaptador — solo credenciales BYOK.

​
Planes de un vistazo

Los precios y los límites de tasa cambian. Siempre confirma en synthetic.new/pricing antes de elegir un nivel.

​
Suscripción (recomendada para revisión de código)

PlanPrecioLímite de tasa
Mensual~30/mes(30/mes (1/día)~500 mensajes por ventana de 5 horas
Enterprise / basado en usocontactar a Syntheticopción de pago por token
  • Todos los modelos estándar están cubiertos por la suscripción — elige cualquiera de ellos cambiando el campo model.
  • Los límites de tasa se aplican en una ventana continua de 5 horas, no por mes — planifica la concurrencia para que quepa dentro de esa ventana.
  • Synthetic no entrena con tus prompts/completaciones y elimina los datos de la API en 14 días.

​
Modelos recomendados

Synthetic expone modelos usando un prefijo estilo HuggingFace (hf:org/model). Algunas opciones sólidas para revisión de código:
ID del modeloNotas
hf:zai-org/GLM-4.6Familia GLM; equilibrado para revisión de propósito general.
hf:moonshotai/Kimi-K2-InstructKimi K2 de contexto largo — excelente en PRs grandes.
hf:Qwen/Qwen3-Coder-480B-A35B-InstructCodificador especializado robusto.
hf:deepseek-ai/DeepSeek-V3.1DeepSeek V3.1; comportamiento agéntico/de codificación robusto.
Consulta el catálogo completo en dev.synthetic.new/docs/openai/models.

​
Crear una clave API

Se requiere una cuenta de Synthetic con una suscripción activa para usar la API.
  1. Ve a synthetic.new y regístrate o inicia sesión.
  2. Suscríbete a un plan en synthetic.new/pricing.
  3. Abre la consola de desarrollador y crea una clave API. Cópiala de inmediato — no verás la clave completa nuevamente.

​
Configurar Synthetic en Kodus

El flujo principal es BYOK en Kodus Cloud. Las instalaciones con alojamiento autónomo pueden usar variables de entorno como opción secundaria.

​
Opción 1 — BYOK en Kodus Cloud (recomendado)

  1. En la interfaz web de Kodus, abre Configuración → BYOK y haz clic en Editar en el modelo Principal (o Respaldo).
  2. Cambia el formulario al modo Personalizado para poder ingresar una URL base y un nombre de modelo libre.
  3. Completa los campos:
    CampoValor
    ProveedorOpenAI Compatible
    Clave APItu clave API de Synthetic
    URL Basehttps://api.synthetic.new/openai/v1
    Modelopor ejemplo, hf:zai-org/GLM-4.6 (usa el prefijo hf: y la ruta completa de HuggingFace)
    Máx. de Solicitudes Concurrentescomienza con 3–5 para ajustarse al presupuesto de 5 horas en PRs más grandes
    Máx. de Tokens de Salidadeja el valor predeterminado a menos que tengas truncamiento
  4. Guarda. Kodus valida contra el endpoint y muestra cualquier error 401 / 404 de inmediato.
  5. Abre cualquier PR para activar una revisión; el indicador de estado BYOK en Configuración se pone verde en la primera llamada exitosa.
El presupuesto de 500 mensajes cada 5 horas es por suscripción, no por PR. Para equipos que hacen revisión continua intensa, mantén las Solicitudes Concurrentes Máximas lo suficientemente bajas para que un PR grande con múltiples archivos no consuma toda la ventana, o distribuye el trabajo entre varias suscripciones.
Configura Synthetic como Principal y mantén una clave de OpenAI o Anthropic como Respaldo — cuando la ventana de 5 horas se llene, Kodus conmuta automáticamente y las revisiones siguen fluyendo.

​
Opción 2 — Alojamiento autónomo (variables de entorno)

Si ejecutas Kodus en Modo Fijo (proveedor global único, sin BYOK por organización), configura Synthetic en el .env de tus contenedores de API + worker: 
# Configuración de Synthetic (Modo Fijo)
API_LLM_PROVIDER_MODEL="hf:zai-org/GLM-4.6"                    # cualquier ID de modelo del catálogo
API_OPENAI_FORCE_BASE_URL="https://api.synthetic.new/openai/v1"
API_OPEN_AI_API_KEY="your-synthetic-api-key"
Esta opción solo es necesaria para instalaciones de Kodus con alojamiento autónomo que deshabilitan deliberadamente el BYOK. Si el BYOK está habilitado en tu instancia con alojamiento autónomo, prefiere la Opción 1 — el flujo basado en la interfaz es el mismo que en Cloud.
Reinicia los contenedores de API y worker después de editar .env, luego verifica: 
docker-compose logs api worker | grep -iE "synthetic|api\.synthetic"
Para la configuración completa con alojamiento autónomo (dominios, claves de seguridad, base de datos, webhooks, proxy inverso), sigue la guía de despliegue en VM genérica y solo reemplaza el bloque LLM con el anterior.

​
Cuándo elegir Synthetic

  • Tu modelo principal es de código abierto (Kimi, DeepSeek, Qwen Coder, GLM) y quieres una sola factura a tarifa plana en lugar de gestionar el gasto por token de cada proveedor.
  • **Estás comparando con Claude Max (200/mes)∗∗paraelrendimientoderevisiones—Synthetica200/mes)** para el rendimiento de revisiones — Synthetic a 30/mes ofrece varias veces el presupuesto de límite de tasa para modelos de codificación de capacidad similar.
  • Quieres una postura de datos sólida — Synthetic es explícito sobre no-entrenamiento y retención de prompts/completaciones por 14 días.
Elige pago por token (Moonshot, Fireworks, Together, Groq) si tu tráfico es irregular, o una suscripción diferente (Z.AI GLM Coding Plan) si específicamente quieres la familia GLM con compromisos por niveles.

​
Solución de problemas

  • El presupuesto de la suscripción es por ventana continua de 5 horas, no por hora ni por mes. Verifica cuántas solicitudes has enviado recientemente en el panel de Synthetic.
  • Espera a que avance la ventana, reduce las Solicitudes Concurrentes Máximas en BYOK, o actualiza/apila planes.
  • Configura un proveedor BYOK de Respaldo para que las revisiones sigan funcionando mientras estás limitado por tasa.
  • Confirma que la clave esté activa y la suscripción esté vigente en el panel de Synthetic.
  • Asegúrate de que no haya espacios al final ni comillas en el valor del .env.
  • Algunos modelos más grandes pueden tardar en arrancar la primera vez que se usan después de un período de inactividad.
  • Si la latencia de la primera llamada está bloqueando las verificaciones de salud de Kodus, calienta el modelo enviando una solicitud de prueba pequeña antes de abrir PRs.
  • Confirma que tu servidor pueda alcanzar api.synthetic.new.
  • Revisa los registros de la API y del worker para ver el error upstream exacto.

​
Relacionado