Quickstart

Isso leva cerca de cinco minutos: crie uma stack, gere uma key, envie sua primeira requisição.

1. Crie uma stack#

No dashboard, clique em New stack, dê um nome a ela e escolha um plano. O modelo que esse plano roda é atribuído automaticamente — você não precisa escolher um, a menos que esteja no Enterprise.

2. Gere uma API key#

Abra a stack, vá em API keys e crie uma. A key em texto plano é exibida apenas uma vez, na criação — copie-a agora.

STAC_API_KEY=stac_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
STAC_BASE_URL=https://api.trystac.com/v1

3. Envie uma requisição#

O campo model é ignorado — sua stack sempre atende com o próprio modelo, então qualquer valor funciona ali.

curl "https://api.trystac.com/v1/chat/completions" \
  -H "Authorization: Bearer $STAC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

from openai import OpenAI
 
client = OpenAI(
    api_key=os.environ["STAC_API_KEY"],
    base_url=os.environ["STAC_BASE_URL"],
)
 
response = client.chat.completions.create(
    model="",  # ignorado — sua stack define isso
    messages=[{"role": "user", "content": "Hello"}],
)
 
print(response.choices[0].message.content)

import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: process.env.STAC_API_KEY,
  baseURL: process.env.STAC_BASE_URL,
});
 
const response = await client.chat.completions.create({
  model: "", // ignorado — sua stack define isso
  messages: [{ role: "user", content: "Hello" }],
});
 
console.log(response.choices[0].message.content);

4. Faça streaming da resposta#

Adicione "stream": true para receber os tokens conforme são gerados, como server-sent events:

curl "https://api.trystac.com/v1/chat/completions" \
  -H "Authorization: Bearer $STAC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{ "role": "user", "content": "Hello" }],
    "stream": true
  }'

Veja Streaming responses para saber como consumir o stream em Python e Node.

Usando um cliente no estilo Anthropic#

Se a sua ferramenta fala a API Messages da Anthropic (Claude Code, por exemplo), aponte-a para a Stac da mesma forma:

ANTHROPIC_BASE_URL=https://api.trystac.com
ANTHROPIC_AUTH_TOKEN=$STAC_API_KEY

Requisições para /v1/messages funcionam com a mesma key, sem configuração separada.

Próximos passos#

• Core concepts — stacks, planos, API keys.
• Authentication — formato da key, expiração, erros.
• API reference — todos os parâmetros de requisição.