Modelle & Preise

Modelle

Authentifizierung

ja, API-Schlüssel

Format

JSON

Abrechnung

keine Modellkosten

GET /v1/models liefert die Modelle, die der aufrufende Schlüssel verwenden darf. Die Antwort hat die Form der OpenAI-Modellliste (object: "list" mit data). Die Liste enthält

• die Modelle eigener Anbieter-Schlüssel (BYOK) Ihrer Organisation,
• die von Noirdoc verwalteten Modelle, wenn Ihre Organisation sie nutzen darf.

Das Gateway filtert die Liste mit denselben Regeln wie die Anfragen selbst: Die Einstufung der Organisation als Berufsgeheimnisträger, die Einschränkungen des Schlüssels und seine erlaubten Modelle gelten auch hier. Gibt es dieselbe ID bei einem eigenen und einem verwalteten Anbieter, gilt der eigene.

Die Liste ist nach id sortiert und enthält Modelle aller Endpunkt-Familien. Die Familie steht in endpoint_family: chat für /v1/chat/completions, /v1/responses und /v1/messages, embeddings für /v1/embeddings, stt für /v1/audio/transcriptions, tts für /v1/audio/speech und image_gen für /v1/images/generations. Das API-Format des Anbieters (OpenAI oder Anthropic) steht nicht in der Liste. Rufen Sie ein Modell über einen Endpunkt einer anderen Familie oder eines anderen API-Formats auf, antwortet das Gateway mit dem Fehlercode wrong_endpoint_for_model.

curl https://api.noirdoc.de/v1/models \
  -H "Authorization: Bearer $NOIRDOC_API_KEY"

for model in client.models.list():
    print(model.id)

for await (const model of client.models.list()) {
  console.log(model.id);
}

{
  "object": "list",
  "data": [
    {
      "id": "qwen3.8-27b",
      "object": "model",
      "owned_by": "platform",
      "display_name": "Qwen 3.8 27B",
      "endpoint_family": "chat",
      "legacy_public_id": null
    }
  ]
}

GET /v1/prices ist die öffentliche Preisliste der von Noirdoc verwalteten Modelle. Der Endpunkt braucht keinen Schlüssel. Er enthält nur aktive Modelle mit vollständigem Preis. Modelle eigener Anbieter-Schlüssel stehen nie darin.

Die Liste hat eine Zeile je Modell und Anbieter. Bieten mehrere Anbieter dieselbe Modell-ID an, erscheint die ID mehrfach, mit dem jeweiligen Anbieter und Preis. Welchen Anbieter das Gateway wählt, erklärt Anbieter & Routing.

curl https://api.noirdoc.de/v1/prices

import httpx

response = httpx.get("https://api.noirdoc.de/v1/prices")
prices = response.json()["data"]

const res = await fetch("https://api.noirdoc.de/v1/prices");
const { data: prices } = await res.json();

{
  "object": "list",
  "data": [
    {
      "public_id": "qwen3.8-27b",
      "legacy_public_id": null,
      "provider_slug": "<anbieter-slug>",
      "provider_display_name": "<Anbieter>",
      "price_input": 0.3,
      "price_output": 2.2,
      "price_cache_read": null,
      "price_cache_write": null,
      "price_cache_write_1h": null,
      "long_context_threshold": null,
      "price_input_long": null,
      "price_output_long": null,
      "price_cache_read_long": null,
      "price_cache_write_long": null,
      "price_unit": "per1MTokens",
      "price_currency": "EUR"
    }
  ]
}