Quickstart

npm install @gatelit/sdk

import { signToken } from "@gatelit/sdk/sign"

const token = await signToken(
  {
    sub: "user_123",        // your user's ID
    model: "openai/gpt-4o-mini", // lock the token to one model
    ttl: 60,               // expires in 60 seconds (default)
  },
  process.env.GATELIT_SIGNING_SECRET!,
)

// Example: Next.js API route — app/api/ai-token/route.ts
import { signToken } from "@gatelit/sdk/sign"

export async function GET(request: Request) {
  // Verify the user is authenticated with your own auth system first
  const token = await signToken(
    { sub: "user_123", model: "openai/gpt-4o-mini", ttl: 60 },
    process.env.GATELIT_SIGNING_SECRET!,
  )
  return Response.json({ token })
}

import { GatelitClient } from "@gatelit/sdk"

const client = new GatelitClient({
  gatewayUrl: "https://your-gateway.example.com",
  getToken: async () => {
    const { token } = await fetch("/api/ai-token").then(r => r.json())
    return { token, scheme: "GatelitSigned" }
  },
})

const response = await client.chat({
  model: "openai/gpt-4o-mini",
  messages: [
    { role: "user", content: "What is an AI gateway?" },
  ],
})

console.log(response.content)
// → "An AI gateway is a proxy layer that sits between..."

interface ChatResponse {
  content: string          // the assistant's response text
  model: string            // resolved model, e.g. "openai/gpt-4o-mini"
  usage: {
    inputTokens: number
    outputTokens: number
    totalTokens: number
  } | null
  finishReason: string | null  // e.g. "stop"
  meta: {
    requestId: string      // use this to look up the request in the dashboard
    model: string
  }
}

const response = await client.chat({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "What is an AI gateway?" }],
})

console.log(response.content)
console.log(`Used ${response.usage?.totalTokens} tokens`)
console.log(`Request ID: ${response.meta.requestId}`)