Quickstart

Esto toma unos cinco minutos: crea un stack, genera una key, envía tu primera solicitud.

1. Crea un stack#

Desde el dashboard, haz clic en New stack, dale un nombre y elige un plan. El modelo que ese plan ejecuta se asigna automáticamente — no necesitas elegir uno, salvo que estés en Enterprise.

2. Genera una API key#

Abre el stack, ve a API keys y crea una. La key en texto plano se muestra una única vez, al crearla — cópiala ahora.

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

3. Envía una solicitud#

El campo model se ignora — tu stack siempre responde con su propio modelo, así que cualquier valor sirve ahí.

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="",  # se ignora — tu stack lo define
    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: "", // se ignora — tu stack lo define
  messages: [{ role: "user", content: "Hello" }],
});
 
console.log(response.choices[0].message.content);

4. Transmite la respuesta#

Agrega "stream": true para recibir los tokens a medida que se generan, 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
  }'

Consulta Streaming responses para ver cómo consumir el stream en Python y Node.

Usando un cliente al estilo Anthropic#

Si tu herramienta habla la API Messages de Anthropic (Claude Code, por ejemplo), apúntala a Stac de la misma forma:

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

Las solicitudes a /v1/messages funcionan con la misma key, sin configuración aparte.

Próximos pasos#

• Core concepts — stacks, planes, API keys.
• Authentication — formato de la key, expiración, errores.
• API reference — todos los parámetros de solicitud.