Dateien

Dateien erreichen ein Modell auf zwei Wegen:

• Inline im Body: als Base64-data:-URL in einer Nachricht an /v1/chat/completions, /v1/responses oder /v1/messages. Diese Dateien kann das Gateway prüfen und maskieren.
• Hochladen über /v1/files: Das Gateway reicht die Datei unverändert an den Anbieter weiter. Nachrichten verweisen dann per file_id darauf.

Dateiinhalte zulassen

Unter Models → Datenschutz im Abschnitt Dateien steht der Schalter Dateiinhalte zulassen. Standard ist an. Ist er aus, lehnt das Gateway diese Anfragen mit 403 file_content_not_allowed ab:

• Nachrichten mit Datei-, Bild- oder Audio-Teilen, auch mit file_id-Verweis
• alle Anfragen an /v1/files und /v1/skills
• Transkriptionen über /v1/audio/transcriptions

Dateien inline senden

curl https://api.noirdoc.de/v1/chat/completions \
  -H "Authorization: Bearer $NOIRDOC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Noirdoc-Mask: on" \
  -d '{
    "model": "qwen3.8-27b",
    "messages": [{
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Fassen Sie den Vertrag zusammen."
        },
        {"type": "file", "file": {
          "filename": "vertrag.pdf",
          "file_data": "data:application/pdf;base64,JVBERi0..."
        }}
      ]
    }]
  }'

Dateianalyse-Modus wählen

Admins stellen den Modus unter Models → Datenschutz im Abschnitt Dateien ein. Er wirkt auf Inline-Dateien in Anfragen, die das Gateway maskiert. Im Standardmodus Durchreichen erreichen Dateien den Anbieter auch bei eingeschalteter Maskierung unverändert.

Zwei weitere Einstellungen im selben Abschnitt:

• Maximale Dateigröße: Größere Dateien analysiert das Gateway nicht. Standard ist 25 MB.
• OCR für Scans und Bilder: Ohne OCR liest das Gateway keinen Text aus Bildern und gescannten PDFs; solche Dateien prüft es dann nicht. Standard ist aus.

In den Modi block und pseudonymize leitet das Gateway keine Datei weiter, die es nicht prüfen konnte. Überschreitet eine Datei die maximale Dateigröße, lässt sie sich nicht öffnen oder auslesen oder kennt das Gateway ihr Format nicht, antwortet es mit 422 file_unprocessable. Das gilt für jedes Format, auch für PDFs und Bilder. Die Datei erreicht den Anbieter dann nicht. Speichern Sie sie neu oder in einem anderen Format (etwa PDF, DOCX oder XLSX), verkleinern Sie sie oder lassen Sie sie weg.

Ausnahme sind Bilder und gescannte PDFs ohne Textebene, solange OCR für Scans und Bilder aus ist. Solche Dateien leitet das Gateway weiter, ohne sie zu prüfen. Schalten Sie OCR ein, wenn auch diese Dateien geprüft werden sollen.

Dateien hochladen

curl https://api.noirdoc.de/v1/files \
  -H "Authorization: Bearer $NOIRDOC_API_KEY" \
  -F purpose="user_data" \
  -F file="@vertrag.pdf"

import os
from openai import OpenAI

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

uploaded = client.files.create(
    file=open("vertrag.pdf", "rb"), purpose="user_data"
)
print(uploaded.id)

import fs from "node:fs";
import OpenAI from "openai";

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

const uploaded = await client.files.create({
  file: fs.createReadStream("vertrag.pdf"),
  purpose: "user_data",
});
console.log(uploaded.id);

Verwaltete Anbieter

Über von Noirdoc verwaltete Anbieter teilen sich mehrere Organisationen ein Konto beim Anbieter. Das Gateway ordnet deshalb jede hochgeladene Datei Ihrer Organisation zu:

• GET /v1/files listet die Dateien Ihrer Organisation.
• Eine file_id einer anderen Organisation behandelt das Gateway wie eine unbekannte: 404 object_not_found. Das gilt auch für Verweise in Nachrichten.

Mit einem eigenen Anbieter (BYOK) gilt diese Zuordnung nicht; dort sehen Sie das Konto Ihres Anbieters.

Skills

/v1/skills reicht Anfragen an die Skills-API von Anthropic durch, ebenfalls ohne Maskierung. Für enforced und X-Noirdoc-Mask: on gilt dieselbe Regel wie bei /v1/files: Das Anlegen von Skills und Versionen lehnt das Gateway dann ab. Die Endpunkte im Detail stehen unter Dateien & Skills.

Fehler