TypeScript SDK

npm install caistro
# or
yarn add caistro
# or
bun add caistro

import { Caistro } from "caistro";

const caistro = new Caistro({
  apiKey: process.env.CAISTRO_API_KEY,
});

async function main() {
  const response = await caistro.chat({
    messages: [
      { role: "user", content: "How do I scale Meta ads?" }
    ],
  });

  console.log(response.choices[0].message.content);
}

main();

const caistro = new Caistro({
  apiKey: "cai_...",           // Required
  baseUrl: "https://api.caistrolabs.com", // Optional, defaults to production
});

const response = await caistro.chat({
  messages: [
    { role: "system", content: "You are a marketing expert." },
    { role: "user", content: "How do I improve my CTR?" }
  ],
  temperature: 0.7,
  max_tokens: 500,
});

const models = await caistro.listModels();
console.log(models.data);

import { Caistro, CaistroError } from "caistro";

try {
  const response = await caistro.chat({ messages: [...] });
} catch (error) {
  if (error instanceof CaistroError) {
    console.error(`API Error ${error.status}: ${error.message}`);
  }
}

interface Message {
  role: "user" | "assistant" | "system";
  content: string;
}

interface ChatRequest {
  messages: Message[];
  model?: string;
  temperature?: number;
  max_tokens?: number;
}

interface ChatResponse {
  id: string;
  object: string;
  model: string;
  choices: ChatChoice[];
  usage: {
    prompt_tokens: number;
    completion_tokens: number;
    total_tokens: number;
  };
}