Conceptos principales

Stac está organizado en torno a tres objetos: cuentas, stacks y API keys.

Cuenta#

Tu cuenta es tu identidad y entidad de facturación. No contiene configuración por sí sola — todo lo que afecta el comportamiento de las solicitudes vive en un stack.

Stack#

Un stack es un modelo desplegado, corriendo en capacidad dimensionada según un plan. Una cuenta puede tener varios stacks, cada uno con su propio plan y su propia configuración:

• Plan — Go, Pro, Max o Enterprise. Fijo por stack; determina el modelo y la capacidad detrás de él.
• System prompt — opcional, restringido a ese stack únicamente.
• Base de conocimiento — documentos que subes para recuperación, también restringidos a ese stack. El acervo es del stack; qué keys lo consultan es una opción de cada key.
• API keys — cada key pertenece exactamente a un stack.

Las solicitudes nunca eligen un modelo — el stack al que llamas ya tiene uno asignado, y cualquier campo model que envíes se ignora.

API keys#

Una key autentica solicitudes contra un stack específico. Las keys tienen el prefijo stac_ y se muestran completas solo una vez, al crearlas — Stac almacena un hash, no la key en sí. Una key puede, opcionalmente, recibir una fecha de expiración; después de eso, las solicitudes con ella son rechazadas.

Cada key también lleva su propia configuración, independiente de las demás del mismo stack: system prompt propio, parámetros de generación y si consulta la base de conocimiento del stack. Es lo que permite usar un solo stack para cosas distintas — la key de la automatización consulta el acervo, la de la herramienta de código no — sin cambiar el código que llama a la API.

Próximos pasos#

• Authentication — formato de la key, expiración, respuestas de error.
• Pricing model — qué incluye cada plan.
• API reference — todos los parámetros de solicitud.