Catálogo de modelos

Una suscripción Theus da acceso a los mejores modelos frontier de código y razonamiento a través de una sola API key — y solo se marca «Disponible» lo verificado contra su proveedor. Theus configura de forma central las keys de cada proveedor upstream: tú nunca las ves ni las gestionas. Este catálogo es el único lugar del producto donde se muestran los nombres reales de los modelos.

Cómo funciona

El CLI y la API hablan siempre con el gateway de Theus (https://theus.pe/v1) usando el id Theus del modelo (p. ej. claude-sonnet-5, gpt-5-1-codex). El gateway resuelve, en cada petición, a qué proveedor upstream y con qué modelo real hacer proxy. La respuesta nunca expone el modelo upstream: el campo model devuelto es el id Theus que pediste.

Suscriptor ──(1 sola key Theus)──▶ Gateway Theus ──(keys de proveedor, gestionadas)──▶ proveedores upstream
                                        │
                                        └── TITAN: decide qué modelo(s) usar, orquesta y sintetiza

Los modelos incluidos

El plan Free incluye TITAN y el modelo local; cualquier plan de pago (Pro Code o superior) desbloquea el catálogo de código y razonamiento. Las modalidades creativas (imagen y video) se incluyen desde Studio AI y no cuentan dentro del catálogo de código: son modalidades aparte.

Ruteo: id Theus → proveedor upstream

La resolución del transporte es dinámica y sigue esta prioridad:

1. Rutas gestionadas (model_routes, consola admin): el mapeo modelo Theus → {proveedor, modelo upstream} se administra desde el panel. Cada modelo puede ir a un proveedor distinto (multi-proveedor real), y un cambio en el panel aplica al instante porque el store se lee por request.
2. Fallback por entorno (THEUS_MODEL_MAP): un objeto JSON {"id-theus": "modelo-upstream"} (inline o ruta a archivo). Una entrada del mapa es la verdad del operador y habilita ese modelo aunque el catálogo lo marque como planificado. Sirve también para definir alias propios fuera del catálogo.
3. Default del gateway: solo aplica en despliegues sin rutas gestionadas (env-only): ahí los modelos ready del catálogo sin mapeo caen al modelo por defecto del upstream principal (THEUS_UPSTREAM_MODEL). Si el despliegue gestiona rutas en el panel (model_routes con al menos una entrada), un modelo sin ruta y sin THEUS_MODEL_MAP no cae al default: es fail-closed (integridad de facturación — nunca se sirve otro modelo reetiquetado ni se cobra con el peso del modelo pedido), responde 404 model_not_found honesto y no aparece en /v1/models. Ojo: basta una sola ruta —aunque sea solo de embeddings, imagen o video— para activar el modo gestionado; al crear la primera ruta, rutea también los modelos de texto que quieras seguir sirviendo (o decláralos en THEUS_MODEL_MAP). Los modelos de imagen y video nunca usan el default en ningún modo (es un modelo de texto): sin ruta gestionada o entrada en THEUS_MODEL_MAP no se sirven ni se anuncian.

Si un modelo no resuelve a ningún upstream, /v1/chat/completions responde 404 model_not_found con la lista de modelos disponibles hoy.

theus-embed — memoria semántica

theus-embed es el alias de embeddings del gateway: la capa semántica que usa el CLI para el recall del proyecto (memoria). Se consume por POST /v1/embeddings (compatible OpenAI) y se rutea desde el panel admin (model_routes) a cualquier proveedor con API de embeddings OpenAI-compatible. Su consumo entra al mismo ledger de tokens que el chat.

• Nunca actúa como trabajador de TITAN: los modelos de embeddings no generan texto para subtareas.
• Requiere un proveedor con endpoint /embeddings; un proveedor con API nativa anthropic no ofrece embeddings y el gateway lo rechaza con un error accionable.

/v1/models — el catálogo servible

GET /v1/models (autenticado) devuelve, en formato de lista OpenAI, solo los modelos realmente servibles hoy: los del catálogo que resuelven a un upstream concreto, más los alias definidos en THEUS_MODEL_MAP o en rutas gestionadas con proveedor operativo. Cada entrada añade name, modality, tier y status a los campos estándar.

curl https://theus.pe/v1/models \
  -H "Authorization: Bearer $THEUS_API_KEY"