Responses

curl https://api.noirdoc.de/v1/responses \
  -H "Authorization: Bearer $NOIRDOC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<modell-id>",
    "instructions": "Antworten Sie in drei Sätzen.",
    "input": "Was schreibt Herr Müller der Kanzlei?"
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.noirdoc.de/v1",
    api_key=os.environ["NOIRDOC_API_KEY"],
)

response = client.responses.create(
    model="<modell-id>",
    instructions="Antworten Sie in drei Sätzen.",
    input="Was schreibt Herr Müller der Kanzlei?",
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.noirdoc.de/v1",
  apiKey: process.env.NOIRDOC_API_KEY,
});

const response = await client.responses.create({
  model: "<modell-id>",
  instructions: "Antworten Sie in drei Sätzen.",
  input: "Was schreibt Herr Müller der Kanzlei?",
});
console.log(response.output_text);

Was Noirdoc ändert

Verweise auf gespeicherte Objekte

Die von Noirdoc verwalteten Anbieter nutzen ein gemeinsames Konto für alle Organisationen. Dort prüft das Gateway jeden Verweis im Body:

• previous_response_id, referenzierte Dateien (file_id) und Container müssen über Ihre Organisation entstanden sein. Sonst antwortet das Gateway mit 404 object_not_found.
• conversation, prompt.id, input[]-Einträge vom Typ item_reference, input[]-Einträge, die nur eine id ohne Inhalt tragen, und tools[].vector_store_ids lehnt das Gateway mit 403 reference_not_available_on_platform ab.

Mit einem eigenen Anbieter-Schlüssel (BYOK) entfallen diese Prüfungen.

Unterrouten

input_tokens und compact verlangen model und laufen wie POST /v1/responses über den Katalog. Ist die Maskierung aktiv, maskiert das Gateway auch hier instructions und input.

Die Aufrufe mit {id} tragen kein Modell. Das Gateway leitet sie an den ältesten aktiven Anbieter im OpenAI-Format Ihrer Organisation weiter. Eigene Anbieter-Schlüssel (BYOK) haben Vorrang. Bei von Noirdoc verwalteten Anbietern erreichen Sie nur Antworten, die über Ihre Organisation entstanden sind. Für alle anderen IDs antwortet das Gateway mit 404 object_not_found.

Beim Abrufen stellt das Gateway keine Originalwerte wieder her. War die ursprüngliche Anfrage maskiert, enthalten GET /v1/responses/{id} und input_items die Platzhalter.

Andere Pfade unter /v1/responses/ beantwortet das Gateway mit 404 unsupported_endpoint.

input_tokens erzeugt keine Antwort des Modells. Das Gateway protokolliert den Aufruf, rechnet ihn aber nicht ab. Eine Kostenschätzung vor der Weiterleitung entfällt. Bei von Noirdoc verwalteten Anbietern gilt trotzdem: Ist das Guthaben der Organisation oder das Budget des Schlüssels aufgebraucht, antwortet das Gateway mit 402. compact rechnet das Gateway wie POST /v1/responses nach Tokens ab.

Fehler auf diesem Endpunkt

OpenAI-Referenz

Alle übrigen Felder von Anfrage und Antwort beschreibt die API-Referenz von OpenAI: Responses (geprüft am 30.09.2026).