Dateien & Skills

Familie

Durchleitung

Maskierung

nein

Streaming

nein

Format

wie beim Anbieter, Hochladen als multipart/form-data

Abrechnung

keine

Voraussetzungen

Dateien und Skills funktionieren nur, wenn Admins Ihrer Organisation unter Models → Datenschutz die Option Dateiinhalte zulassen eingeschaltet haben. Sonst antwortet das Gateway mit 403 file_content_not_allowed.

Weil das Gateway hier nicht maskiert, lehnt es Aufrufe mit Inhalt ab, wenn die Anfrage Maskierung verlangt: bei der Maskierungsrichtlinie enforced oder mit dem Header X-Noirdoc-Mask: on. Das betrifft alle Methoden außer GET, HEAD, OPTIONS und DELETE, also etwa das Hochladen einer Datei und das Anlegen eines Skills oder einer Version. Das Gateway antwortet dann mit 403 masking_not_supported_for_endpoint. Auflisten, Abrufen, Herunterladen und Löschen bleiben erlaubt.

Anbieter wählen

Diese Aufrufe tragen kein Modell. Das Gateway bestimmt deshalb zuerst das API-Format und leitet den Aufruf dann an den ältesten aktiven Anbieter dieses Formats weiter. Anbieter, die Ihre Organisation selbst verbunden hat (BYOK), haben Vorrang. Claude über Google Vertex kommt dafür nicht in Frage.

X-Provider wählt nur das Format. Die Einschränkungen Ihres Schlüssels und Ihrer Organisation gelten weiter. Ist für das Format kein Anbieter eingerichtet, antwortet das Gateway mit 502 provider_not_configured.

Das Anthropic-SDK sendet den Schlüssel als x-api-key. Das Gateway leitet den Aufruf dann an einen Anthropic-Anbieter weiter. Das OpenAI-SDK sendet Authorization: Bearer und landet bei einem Anbieter im OpenAI-Format.

Nutzt ein Anthropic-Client Authorization: Bearer, setzen Sie X-Provider: anthropic.

curl https://api.noirdoc.de/v1/files \
  -H "Authorization: Bearer $NOIRDOC_API_KEY" \
  -H "X-Provider: anthropic" \
  -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"],
)

with open("vertrag.pdf", "rb") as f:
    uploaded = client.files.create(file=f, 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);