Mint a key per user.
Cap their spend.
Get paid.

// Mint a per-user qlaud key with a hard cap.
// — In Next.js API route, Express, Hono, Fastify… same call.
const r = await fetch('https://api.qlaud.ai/v1/keys', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.QLAUD_MASTER_KEY,
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    name: 'user_42',          // any unique label (your user id works)
    max_spend_usd: 5,         // hard cap — enforced gateway-side
  }),
});
const { secret: userKey, max_spend_usd } = await r.json();
// userKey === 'qlk_live_…'         the api key for that user
// max_spend_usd === 5              the cap qlaud now enforces

// userKey from step 1 above.
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.qlaud.ai/v1',
  apiKey: userKey,
});

await client.chat.completions.create({
  model: 'claude-sonnet-4-6',          // any qlaud catalog slug
  messages: [{ role: 'user', content: 'hello' }],
});

// Pull per-user spend from qlaud. Use the numbers however you bill
// your end-users — Stripe, Paddle, Lemon Squeezy, in-app invoicing,
// custom logic. qlaud bills YOU for the qlaud wallet; YOU bill your users.
const usage = await fetch('https://api.qlaud.ai/v1/usage', {
  headers: { 'x-api-key': process.env.QLAUD_MASTER_KEY! },
}).then(r => r.json());

for (const k of usage.by_key) {
  // k.key_name was your label when minting (e.g. 'user_42').
  // k.cost_micros already includes our 7% markup.
  console.log(`${k.key_name}: $${(k.cost_micros / 1_000_000).toFixed(4)}`);

  // → Hand to your billing tool. Example with Stripe:
  //   stripe.invoiceItems.create({
  //     customer: stripeCustomerFor(k.key_name),
  //     amount: Math.floor(k.cost_micros / 100),
  //   });
}