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.
• 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.

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.