Models

Retrieve all available models

get

This endpoint retrieves information about all available models. An optional API key can be provided via the Authorization header; when present, results are scoped to the models and providers available based on the inference settings. Provider filtering parameters mirror those accepted by the chat completions endpoint.

Authorizations

AuthorizationstringOptional

Optional API key. When provided, the response is filtered to only include models and providers available based on the inference settings.

Query parameters

tagstring[]Optional

One or more tags to filter by (defaults to ['Instruct'])

currencystringOptional

ISO currency code for pricing conversion (defaults to 'EUR')

Default: EUR

allowed_providersstring[]Optional

Restrict results to models that are available on at least one of the specified providers. Accepts multiple values.

Example: ["mistral","scaleway"]

eu_nativebooleanOptional

When true, only models hosted by providers that are based and regulated within the EU are returned. Even when false, all endpoints remain GDPR compliant.

allow_quantizationbooleanOptional

When false, quantized model variants are excluded from the results. Defaults to true.

allow_zero_data_retentionbooleanOptional

When true, only models available on providers that offer zero data retention (ZDR) are returned.

extendedbooleanOptional

When true, each model additionally includes a providers_details object with a per-provider breakdown of pricing, quantization, context size, maximum output tokens, supported features, and the latest throughput, latency, TTFT, cache-hit rate, and uptime metrics. Defaults to false.

Default: false

Responses

200

A list of available models

application/json

objectstringRequiredExample: list

401

Invalid or expired API key

500

Internal server error

get/models

GET /v1/models HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "mistral-small-2503",
      "object": "model",
      "created": 1742482730,
      "owned_by": "Mixtral",
      "description": "Mistral Small is a highly efficient model optimized for low latency.",
      "pricing": {
        "input_token": 0.18,
        "output_token": 0.54,
        "currency": "EUR"
      },
      "providers": [
        "mistral"
      ],
      "context_size": 32768,
      "max_output_tokens": 8192,
      "tags": [
        "Instruct"
      ],
      "input_modalities": [
        "text"
      ],
      "output_modalities": [
        "text"
      ],
      "supported_features": [
        "json_mode",
        "tools"
      ],
      "model_series": [
        "mistral-small"
      ]
    },
    {
      "id": "cortecs-large-2503",
      "object": "model",
      "created": 1742570000,
      "owned_by": "Cortecs",
      "description": "Cortecs Large is our flagship model with state of the art capabilities.",
      "pricing": {
        "input_token": 1.8,
        "output_token": 5.4,
        "cache_read_cost": 0.9,
        "cache_write_cost": 3.6,
        "currency": "EUR"
      },
      "providers": [
        "cortecs"
      ],
      "context_size": 131072,
      "max_output_tokens": 16384,
      "tags": [
        "Instruct",
        "Vision"
      ],
      "input_modalities": [
        "text"
      ],
      "output_modalities": [
        "text"
      ],
      "supported_features": [
        "json_mode",
        "reasoning",
        "tools"
      ],
      "model_series": [
        "cortecs-large"
      ]
    }
  ]
}

Retrieve a single model

get

Retrieve detailed information about a specific model. The response always includes the providers_details per-provider breakdown. An optional API key can be provided via the Authorization header; when present, results are scoped to the models and providers available based on the inference settings. The same provider filtering parameters as /models are accepted and are applied to the model's provider list. If no matching model (with at least one allowed provider) is found, null is returned.

Authorizations

AuthorizationstringOptional

Optional API key. When provided, the response is filtered to only include models and providers available based on the inference settings.

Path parameters

model_idstringRequired

The model identifier (e.g. mistral-small-2503).

Query parameters

tagstring[]Optional

One or more tags to filter by (defaults to ['Instruct'])

currencystringOptional

ISO currency code for pricing conversion (defaults to 'EUR')

Default: EUR

allowed_providersstring[]Optional

Restrict the model's provider list to at least one of the specified providers. Accepts multiple values.

Example: ["mistral","scaleway"]

eu_nativebooleanOptional

When true, only providers that are based and regulated within the EU are considered. Even when false, all endpoints remain GDPR compliant.

allow_quantizationbooleanOptional

When false, quantized provider variants are excluded. Defaults to true.

allow_zero_data_retentionbooleanOptional

When true, only providers that offer zero data retention (ZDR) are considered.

Responses

200

The requested model, or null if it was not found.

application/json

idstringRequired

objectstringRequiredExample: model

createdintegerRequired

owned_bystringRequired

descriptionstring · nullableOptional

providersstring[]Required

context_sizeinteger · nullableOptional

The maximum context size for this model.

max_output_tokensinteger · nullableOptional

The largest maximum output-token limit across the available providers.

tagsstring[] · nullableOptional

input_modalitiesstring[]Optional

Supported input modalities (e.g. text, image, audio) derived from the model tags.

output_modalitiesstring[]Optional

Supported output modalities (e.g. text, audio, embeddings) derived from the model tags.

model_seriesstring[] · nullableOptional

401

Invalid or expired API key

500

Internal server error

get/models/{model_id}

GET /v1/models/{model_id} HTTP/1.1
Host: api.cortecs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "cortecs-large-2503",
  "object": "model",
  "created": 1742570000,
  "owned_by": "Cortecs",
  "description": "Cortecs Large is our flagship model with state of the art capabilities.",
  "pricing": {
    "input_token": 1.8,
    "output_token": 5.4,
    "cache_read_cost": 0.9,
    "cache_write_cost": 3.6,
    "currency": "EUR"
  },
  "providers": [
    "cortecs"
  ],
  "context_size": 131072,
  "max_output_tokens": 16384,
  "tags": [
    "Instruct",
    "Vision"
  ],
  "input_modalities": [
    "text"
  ],
  "output_modalities": [
    "text"
  ],
  "supported_features": [
    "json_mode",
    "reasoning",
    "tools"
  ],
  "model_series": [
    "cortecs-large"
  ],
  "providers_details": {
    "cortecs": {
      "pricing": {
        "input_token": 1.8,
        "output_token": 5.4,
        "cache_read_cost": 0.9,
        "cache_write_cost": 3.6,
        "currency": "EUR"
      },
      "quantization": null,
      "context_size": 131072,
      "max_output_tokens": 16384,
      "supported_features": [
        "json_mode",
        "reasoning",
        "tools"
      ],
      "metrics": {
        "throughput": 42.37,
        "latency": 1.28,
        "ttft": 0.34,
        "cache_hit_rate": 0.76,
        "uptime": 0.99
      }
    }
  }
}