TypeScript SDK

$ npm install @lumorig/sdk

import { Lumorig } from "@lumorig/sdk";

const lumorig = new Lumorig({
  apiKey: process.env.LUMORIG_API_KEY, // the default
  baseUrl: "https://lumorig.com",      // default: LUMORIG_URL, then https://lumorig.com
});

import fs from "node:fs";
import { Lumorig } from "@lumorig/sdk";

const lumorig = new Lumorig();

const mascot = await lumorig.mascots.createAndWait({ prompt: "a grumpy cactus who loves hugs", style: "kawaii" });
await lumorig.animations.preset(mascot.id, "celebrate", { intensity: 1.5 });
const { data } = await lumorig.exports.createAndDownload(mascot.id, { format: "lottie", animation: "celebrate" });
fs.writeFileSync("cactus.lottie.json", Buffer.from(data));

const { job } = await lumorig.mascots.create({ image_url: "https://example.com/logo.png" });
const done = await lumorig.jobs.wait(job.id, { timeoutMs: 10 * 60_000 });

if (done.status === "succeeded") console.log("fidelity", done.result.fidelity);
else console.error(done.status, done.error);

for await (const e of lumorig.jobs.events(job.id)) {
  if (e.type === "progress") process.stdout.write(String(e.text));
  if (e.type === "usage") console.log("spent so far $", e.cost_usd);
}

// or, while waiting:
await lumorig.jobs.wait(job.id, { onEvent: (e) => console.log(e.type) });

import { LumorigError } from "@lumorig/sdk";

try {
  await lumorig.mascots.create({ prompt: "a cheerful lighthouse keeper" });
} catch (err) {
  if (err instanceof LumorigError && err.code === "insufficient_credits") {
    const { needed, balance } = err.details as { needed: number; balance: number };
    console.log(`Need ${needed} credits, have ${balance}`);
  } else throw err;
}

import { verifyWebhook } from "@lumorig/sdk";

export async function POST(req: Request) {
  const body = await req.text();
  const ok = await verifyWebhook(body, req.headers.get("lumorig-signature") ?? "", process.env.LUMORIG_WEBHOOK_SECRET!);
  if (!ok) return new Response("bad signature", { status: 400 });
  const event = JSON.parse(body); // { type: "job.succeeded", created_at, data: Job }
  return new Response("ok");
}