OpenAI-Integration

Noirdoc mit dem OpenAI Python- und Node.js-SDK nutzen.

Überblick

Noirdoc ist vollstaendig kompatibel mit dem offiziellen OpenAI SDK. Um Ihre Anfragen über den Noirdoc-Proxy zu leiten, muessen Sie lediglich zwei Parameter aendern: die Base-URL und den API-Key. Der gesamte restliche Code bleibt unveraendert.

Alle personenbezogenen Daten in Ihren Prompts werden automatisch pseudonymisiert, bevor sie OpenAI erreichen. In der Antwort werden die Originalwerte nahtlos wiederhergestellt.

Python — Chat Completions

Installieren Sie das OpenAI-SDK wie gewohnt und passen Sie die Client-Konfiguration an:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.noirdoc.de/v1",
    api_key="px-your-noirdoc-key",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {
            "role": "user",
            "content": "Fasse den Vertrag für Max Mustermann, geboren am 15.03.1985, zusammen."
        }
    ],
)

print(response.choices[0].message.content)

Der Proxy erkennt Max Mustermann und das Geburtsdatum, ersetzt sie durch Pseudonyme wie <<PERSON_1>> und <<DATE_1>>, und stellt die Originalwerte in der Antwort wieder her.

Node.js — Chat Completions

Die Integration mit dem Node.js-SDK funktioniert identisch:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.noirdoc.de/v1",
  apiKey: "px-your-noirdoc-key",
});

const response = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [
    {
      role: "user",
      content: "Schreibe eine E-Mail an anna.schmidt@example.com bezueglich der Rechnung.",
    },
  ],
});

console.log(response.choices[0].message.content);

Streaming

Streaming wird vollstaendig unterstützt. Die Wiederherstellung der Originalwerte erfolgt in Echtzeit. Siehe Streaming für SDK-Beispiele und SSE-Details.

Responses API

Noirdoc unterstützt auch die neuere OpenAI Responses API. Die Konfiguration bleibt identisch:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.noirdoc.de/v1",
    api_key="px-your-noirdoc-key",
)

response = client.responses.create(
    model="gpt-5.4-mini",
    input="Fasse die Akte von Maria Schneider, IBAN DE89370400440532013000, zusammen.",
)

print(response.output_text)

Hinweise

• Der API-Key muss mit px- beginnen. Ihr eigentlicher OpenAI-Key wird sicher im Noirdoc-Portal hinterlegt.
• Alle OpenAI-Modelle werden unterstützt, einschliesslich gpt-5.4-mini, gpt-5.4, gpt-5.4-nano und o3.
• Funktionsaufrufe (Function Calling) und Tool-Nutzung funktionieren transparent durch den Proxy hindurch.
• Die Pseudonymisierung betrifft nur den Inhalt der Nachrichten, nicht die Modellparameter oder Systemkonfiguration.