Onwinds API

Onwinds is een OpenAI‑compatibele gateway voor teams en productiesystemen. Je organisatie stuurt modellen, routing, governance en spend centraal aan, en gebruikers en apps delen hetzelfde control‑plane.

Bekijk API‑referentie Contact

API‑oppervlak

Onwinds exposeert drie publieke endpoints. Ze zijn OpenAI‑compatibel, dus bestaande SDK’s werken met alleen een base‑URL wissel.

Modellen ophalen

geeft de logische modellen van de tenant terug.

Chat completions

ondersteunt streaming en dwingt policy + spend af voordat tokens doorlopen.

Embeddings

routeert embeddings via je allowlist en factureert deterministisch.

Quickstart

Gebruik je Onwinds‑API‑key met een standaard OpenAI‑client. Zet de base‑URL op .

Chat (streaming)

Drop‑in OpenAI SDK‑gebruik; Onwinds dwingt routing, governance en spend af.

import OpenAI from "openai";

const client = new OpenAI({

apiKey: process.env.ONWINDS_API_KEY,

baseURL: "https://api.onwinds.com/v1",

defaultHeaders: {

"x-onwinds-region-required": "eu",

"x-onwinds-retention-mode": "zdr",

});

await client.chat.completions.create({

model: "gpt-5-mini",

stream: true,

max_tokens: 800,

messages: [{ role: "user", content: "Write a board-ready update for Q3." }],

});

Governance‑headers

Governance wordt per request afgedwongen. Gebruik deze headers om EU‑only routing en een strengere retention‑houding af te dwingen.

x-onwinds-region-required

Zet op om een EU‑conforme route te eisen. Als er geen EU‑route bestaat, wordt het request niet uitgevoerd (fail‑closed).

x-onwinds-retention-mode

Zet op om Zero Data Retention te vragen voor Onwinds‑logging, met behoud van billing‑metadata.

Minimal example

curl https://api.onwinds.com/v1/chat/completions \
  -H "Authorization: Bearer ow_…" \
  -H "Content-Type: application/json" \
  -H "x-onwinds-region-required: eu" \
  -H "x-onwinds-retention-mode: zdr" \
  -d '{"model":"gpt-5-mini","stream":true,"max_tokens":256,"messages":[{"role":"user","content":"Write a concise incident update."}]}'

Veelvoorkomende valkuilen

Provider‑retentie verschilt. Onwinds traint niet op prompts of outputs, maar verwerking door providers hangt af van de gekozen provider en je contract/configuratie.
ZDR gaat over Onwinds‑logging. Je krijgt nog steeds de metadata die nodig is voor billing, limits en traceability.
Fail‑closed betekent fail‑fast. Als je EU‑routing vereist en er geen EU‑route is, moet je dit in de client afhandelen (fallback, retries of policy‑wijziging).

Governance‑overzicht →

Embeddings

Embeddings zijn tenant‑gebonden. Gebruik het embeddings‑endpoint met het logische model `onwinds/embeddings`.

Embeddings‑request

OpenAI‑compatibele embeddings‑call via Onwinds.

import OpenAI from "openai";

const client = new OpenAI({

apiKey: process.env.ONWINDS_API_KEY,

baseURL: "https://api.onwinds.com/v1",

});

const res = await client.embeddings.create({

model: "text-embedding-3-small",

input: "Summarize this document in one sentence.",

});

console.log(res.data[0]?.embedding?.length);

Modellen

Bekijk de logische modellen die je tenant heeft ingeschakeld en allowlisted.

Modellen ophalen

Geeft `onwinds/*` logische modellen en metadata terug.

import OpenAI from "openai";

const client = new OpenAI({

apiKey: process.env.ONWINDS_API_KEY,

baseURL: "https://api.onwinds.com/v1",

});

const models = await client.models.list();

console.log(models.data.map((m) => m.id));

Identity‑model

Requests worden altijd uitgevoerd in tenant‑context. API‑keys zijn tenant‑gebonden en de gateway bepaalt context server‑side; clients geven geen tenant‑IDs mee.

Mensen

Gebruikers melden zich aan in de workspace en het platform past automatisch organisatie‑policy toe (allowed models, governance en spend).

Apps & agents

Apps gebruiken een API‑key op de OpenAI‑compatibele endpoints. Elk request wordt deterministisch toegeschreven en gefactureerd.

Errors en tracing

Onwinds retourneert gestructureerde errors en voegt request‑identifiers toe om failures deterministisch te debuggen.

Error‑vorm

Bij fouten ontvang je een machine‑leesbare en (waar beschikbaar) een .

Request‑IDs

Responses bevatten request‑identifiers (bijv. via / ) zodat incidenten zonder giswerk te debuggen zijn.

Loading…

curl https://api.onwinds.com/v1/chat/completions \ -H "Authorization: Bearer ow_…" \ -H "Content-Type: application/json" \ -H "x-onwinds-region-required: eu" \ -H "x-onwinds-retention-mode: zdr" \ -d '{"model":"gpt-5-mini","stream":true,"max_tokens":256,"messages":[{"role":"user","content":"Write a concise incident update."}]}'