TypeScript SDK

npm install @singularity-layer/grid
# pnpm add @singularity-layer/grid · yarn add @singularity-layer/grid

import { GridClient } from "@singularity-layer/grid";

const grid = new GridClient();              // public reads need no key

const res = await grid.chatCompletions({
  model: "<model-id>",                       // see grid.models()
  messages: [{ role: "user", content: "What is confidential compute?" }],
});

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

const grid = new GridClient({
  apiKey: "scg_...",                          // required for job submission / billed calls
  baseUrl: "https://grid.x402compute.cc",     // override the orchestrator URL
  timeout: 30_000,                            // request timeout in ms (default 60000)
});

const cap = await grid.capacity();
console.log(`${cap.active_nodes} nodes online`);

const models = await grid.models();
models.forEach((m) => console.log(`${m.id} — ${m.sgl_node_count} nodes`));

const pricing = await grid.pricing();
pricing.forEach((p) => console.log(`${p.model}: $${p.price_per_1k_input_tokens_usd}/1k input`));

const grid = new GridClient({ apiKey: "scg_..." });

const res = await grid.chatCompletions({
  model: "<model-id>",
  messages: [
    { role: "system", content: "You are concise." },
    { role: "user", content: "Summarize TEEs in one sentence." },
  ],
  max_tokens: 256,
  temperature: 0.7,
});

import { GridClient, type ChatContentPart } from "@singularity-layer/grid";

const grid = new GridClient({ apiKey: "scg_..." });

const res = await grid.chatCompletions({
  model: "qwen2.5-vl-3b",
  messages: [
    {
      role: "user",
      content: [
        { type: "text", text: "What is in this image?" },
        { type: "image_url", image_url: { url: "data:image/png;base64,iVBORw0KGgo..." } },
      ] satisfies ChatContentPart[],
    },
  ],
  max_tokens: 256,
});

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

const grid = new GridClient({ apiKey: "scg_..." });

const res = await grid.embed({
  model: "nomic-embed-text-v1.5",
  input: ["hello world", "bonjour"],
  // dimensions: 256,          // optional: Matryoshka truncation
  // input_type: "query",      // optional: asymmetric-retrieval hint
});

console.log(res.data.length, res.data[0].embedding.length); // 2 768

const grid = new GridClient({ apiKey: "scg_..." });

const job = await grid.submitJob("<model-id>", {
  messages: [{ role: "user", content: "Summarize quantum computing" }],
});

const result = await grid.getJob(job.job_id);
if (result.status === "completed") console.log(result.result);

const att = await grid.getAttestation(job.job_id);   // verify the enclave
console.log(`Verified: ${att.verified}, TEE: ${att.tee_type}`);

import {
  GridClient, SGLAPIError, SGLAuthError, SGLConnectionError, SGLNotFoundError,
} from "@singularity-layer/grid";

try {
  await grid.getJob("nonexistent");
} catch (err) {
  if (err instanceof SGLNotFoundError) { /* 404 */ }
  else if (err instanceof SGLAuthError) { /* 401/403 — bad/missing key */ }
  else if (err instanceof SGLConnectionError) { /* unreachable / timeout */ }
  else if (err instanceof SGLAPIError) { console.log(err.statusCode, err.message); }
}

import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://grid.x402compute.cc/v1", apiKey: "scg_..." });