Models

The models endpoint follows the OpenAI Models API  response shape. For field definitions and general behavior, refer to the OpenAI documentation.

List models

GET /v1/models

Returns an OpenAI-compatible list object:

{
  "object": "list",
  "data": [
    {
      "id": "vercel-ai-gateway/openai/gpt-5.5",
      "object": "model",
      "created": 0,
      "owned_by": "vercel-ai-gateway"
    }
  ]
}

When a provider supplies a model category, an additional type field may be present. It is advisory metadata and is omitted when the provider does not supply it.

Retrieve a model

Use the exact model ID returned by the list endpoint:

GET /v1/models/vercel-ai-gateway/openai/gpt-5.5

The response is the matching model object. An unknown ID returns 404 model_not_found.

Model ID format

Model IDs use the form:

{provider-slug}/{model-id}

Examples:

• vercel-ai-gateway/openai/gpt-5.5: model via a customer-owned Vercel AI Gateway
• my-azure/openai/gpt-5.5: model on a BYOK provider you named my-azure

The provider slug matches the display name of an enabled inference provider in your active organization (normalized to a URL-safe slug). Use GET /v1/models to see the exact IDs available to your key.

Filtering

Your API key carries an API routing policy. Models whose backing provider is below the key’s E-floor are omitted because that key can never use them. Models are not hidden merely because the key’s default data class cannot use their provider: a request may still be valid with an allowed X-Steinkauz-Data-Sensitivity declaration. The concrete request is always checked against the D×E matrix at runtime.

Availability

If one provider is temporarily unreachable, other providers may still appear in the list. An empty data array means no models matched your provider configuration and key environment floor.

Model discovery is intentionally permissive. Steinkauz AI does not hide a model merely because its provider omitted modelType, or because catalog metadata cannot prove that the model supports a particular operation. Provider-adapter capabilities are enforced, and the selected provider returns a runtime error if that individual model cannot perform the requested operation.

Example

curl -sS "$STEINKAUZ_BASE_URL/v1/models" \
  -H "Authorization: Bearer $STEINKAUZ_API_KEY" | jq .