Sample data. Not a customer bill.

SDKs and tools

Planned

Node, Python, frameworks and Docker. CLI and SDK are later.

View

SDKs and tools

$ npm install openai
$ pip install openai
$ import OpenAI from "openai";
$ 
$ const client = new OpenAI({
$   baseURL: "https://api.parezen.com/v1",
$   apiKey: process.env.PAREZEN_API_KEY, // pz_ key. Project and environment come from this key.
$   defaultHeaders: {
$     "X-Parezen-Route": "support-reply",
$     "X-Parezen-Task": "ticket_resolved",
$   },
$ });
$ 
$ await client.chat.completions.create({
$   model: "anthropic/claude-sonnet-4.5",
$   messages: [{ role: "user", content: "Summarise the latest customer ticket." }],
$ });
200 · first request · metadata only

No Parezen SDK for OpenAI-format apps

Change base URL and api key. The CLI and @parezen/sdk are later. Apps that do not speak the OpenAI format cannot use the no-SDK path.

Node

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.parezen.com/v1",
  apiKey: process.env.PAREZEN_API_KEY, // pz_ key. Project and environment come from this key.
  defaultHeaders: {
    "X-Parezen-Route": "support-reply",
    "X-Parezen-Task": "ticket_resolved",
  },
});

await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4.5",
  messages: [{ role: "user", content: "Summarise the latest customer ticket." }],
});

Optional per-request headers

// Optional per-request headers. The client still uses PAREZEN_API_KEY.
await client.chat.completions.create(
  {
    model: "anthropic/claude-sonnet-4.5",
    messages: [{ role: "user", content: "Summarise the latest customer ticket." }],
  },
  {
    headers: {
      "X-Parezen-Trace": "trace_example",
      "X-Parezen-Cache": "off",
    },
  },
);

Default samples send X-Parezen-Route and X-Parezen-Task with defaultHeaders in Node or extra_headers in Python. Project and environment come from the pz_ key, not a header. Optional per-request headers are X-Parezen-Trace and X-Parezen-Cache: off. Self-hosted default is http://localhost:3002/v1. No-SDK snippets only work for apps already on the OpenAI format.

Parezen CLI

Planned

@parezen/sdk

Planned

A typed SDK is later. The OpenAI SDK is the supported path.

First request shows up in logs

$ npm install openai $ pip install openai $ import OpenAI from "openai"; $ $ const client = new OpenAI({ $ baseURL: "https://api.parezen.com/v1", $ apiKey: process.env.PAREZEN_API_KEY, // pz_ key. Project and environment come from this key. $ defaultHeaders: { $ "X-Parezen-Route": "support-reply", $ "X-Parezen-Task": "ticket_resolved", $ }, $ }); $ $ await client.chat.completions.create({ $ model: "anthropic/claude-sonnet-4.5", $ messages: [{ role: "user", content: "Summarise the latest customer ticket." }], $ }); 200 · first request · metadata only

import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://api.parezen.com/v1", apiKey: process.env.PAREZEN_API_KEY, // pz_ key. Project and environment come from this key. defaultHeaders: { "X-Parezen-Route": "support-reply", "X-Parezen-Task": "ticket_resolved", }, }); await client.chat.completions.create({ model: "anthropic/claude-sonnet-4.5", messages: [{ role: "user", content: "Summarise the latest customer ticket." }], });

// Optional per-request headers. The client still uses PAREZEN_API_KEY. await client.chat.completions.create( { model: "anthropic/claude-sonnet-4.5", messages: [{ role: "user", content: "Summarise the latest customer ticket." }], }, { headers: { "X-Parezen-Trace": "trace_example", "X-Parezen-Cache": "off", }, }, );