Conceitos principais

A Stac é organizada em torno de três objetos: contas, stacks e API keys.

Conta#

Sua conta é sua identidade e entidade de cobrança. Ela não guarda configuração por si só — tudo que afeta o comportamento das requisições vive em uma stack.

Stack#

Uma stack é um modelo implantado, rodando em capacidade dimensionada para um plano. Uma conta pode ter várias stacks, cada uma com seu próprio plano e sua própria configuração:

• Plano — Go, Pro, Max ou Enterprise. Fixo por stack; determina o modelo e a capacidade por trás dele.
• System prompt — opcional, restrito a essa stack apenas.
• Base de conhecimento — documentos que você envia para recuperação, também restritos a essa stack. O acervo é da stack; quais keys o consultam é opção de cada key.
• API keys — cada key pertence a exatamente uma stack.

Requisições nunca escolhem um modelo — a stack que você está chamando já tem um atribuído, e qualquer campo model enviado é ignorado.

API keys#

Uma key autentica requisições contra uma stack específica. Keys têm o prefixo stac_ e são exibidas por completo apenas uma vez, na criação — a Stac armazena um hash, não a key em si. Uma key pode, opcionalmente, receber uma data de expiração; depois disso, requisições com ela são rejeitadas.

Cada key também carrega a sua própria configuração, independente das outras da mesma stack: system prompt próprio, parâmetros de geração e se ela consulta a base de conhecimento da stack. É o que permite usar uma stack só para coisas diferentes — a key da automação consulta o acervo, a key da ferramenta de código não — sem mudar nada no código que chama a API.

Próximos passos#

• Authentication — formato da key, expiração, respostas de erro.
• Pricing model — o que cada plano inclui.
• API reference — todos os parâmetros de requisição.