Quick Start

Make your first request through GROUNDROCK in under a minute. We'll install the SDK, create an API key, and stream a chat completion.

1. Install the SDK

npm install @groundrock/sdk

2. Get an API key

Sign in, create a project, and generate a key from Dashboard → API Keys. Keys are scoped per project — never share one key across environments.

3. Your first request

import { Groundrock } from "@groundrock/sdk";

const ai = new Groundrock({ apiKey: process.env.GROUNDROCK_KEY });

const res = await ai.chat({
  model: "openai/gpt-5",
  messages: [{ role: "user", content: "Explain quantum entanglement in one line." }],
});

console.log(res.output_text);

4. Stream responses

const stream = await ai.chat({
  model: "openai/gpt-5",
  messages: [{ role: "user", content: "Write a haiku about latency." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.delta ?? "");
}

5. Swap providers, keep the code

Change one string, get a different provider. Add a fallback array and GROUNDROCK will retry against alternates on failure — automatically.

await ai.chat({
  model: "anthropic/claude-opus-4",
  fallback: ["openai/gpt-5", "google/gemini-3-pro"],
  messages: [{ role: "user", content: "Ship it." }],
});