Models & pricing

Models

Authentication

yes, API key

Format

JSON

Billing

no model costs

GET /v1/models returns the models the calling key may use. The response has the shape of the OpenAI model list (object: "list" with data). The list contains

• the models of your organisation’s own provider keys (BYOK),
• the models managed by Noirdoc, if your organisation may use them.

The gateway filters the list with the same rules as the requests themselves: the organisation’s classification as professionals bound by secrecy, starter credit eligibility (while no confirmed top-up has been made yet, only starter-eligible managed models appear alongside your own BYOK models), the key’s restrictions and its allowed models apply here too. If you also send the X-Noirdoc-Tags header (Request tags (Preview)), the gateway additionally applies the allowed models and provider restrictions of every named tag. If the same ID exists at your own and at a managed provider, your own provider takes precedence.

The list is sorted by id and contains models of all endpoint families. The family is in endpoint_family: chat for /v1/chat/completions, /v1/responses and /v1/messages, embeddings for /v1/embeddings, rerank for /v1/rerank, stt for /v1/audio/transcriptions, tts for /v1/audio/speech and image_gen for /v1/images/generations. Non-model endpoints such as /v1/shield, /v1/files, /v1/skills and /v1/tags do not appear in the list. The provider’s API format (OpenAI or Anthropic) is not in it either. If you call a model through an endpoint of a different family or a different API format, the gateway answers with the error code 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 is the public price list of the models managed by Noirdoc. The endpoint needs no key. It contains all active managed models with a complete price regardless of starter credit status and indicates per row in starter_allowed (boolean) whether the model and provider are included in starter credit. Models of your own provider keys never appear in it.

The list has one row per model and provider. If several providers offer the same model ID, the ID appears several times, each with its provider and price. Providers & routing explains which provider the gateway selects.

At the top level alongside data, the response also carries the shield object with the flat rate for Noirdoc Shield: €0.40 per 1 million inspected input tokens (price_input: "0.40", price_unit: "per1MTokens", currency and price_currency: "EUR"). This charge applies on top of the model price — as well as on BYOK routes when Shield is active and on standalone calls to POST /v1/shield/inspect.

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": "<provider-slug>",
      "provider_display_name": "<Provider>",
      "endpoint_family": "chat",
      "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",
      "starter_allowed": true
    }
  ],
  "shield": {
    "price_input": "0.40",
    "price_unit": "per1MTokens",
    "currency": "EUR",
    "price_currency": "EUR"
  }
}