GET /v1/models — list models from all enabled providers

The /v1/models endpoint returns all models that MonoRelay can currently route to. Rather than reflecting a single provider’s catalog, it aggregates model lists from every enabled provider in your configuration and returns them as a unified list. This means clients that enumerate available models — such as certain chat UIs and SDKs — will see the full set of models across OpenRouter, OpenAI, NVIDIA NIM, and any other configured provider. The endpoint is unauthenticated by default and does not require a Bearer token, making it convenient for model discovery.

Method and path

GET /v1/models

Request body

This endpoint takes no request body.

Response

The response follows the standard OpenAI models list format.

string

Always "list".

object[]

Array of model objects, one per available model.

Show model object properties

string

The model identifier, as it should be passed in the model field of a request.

string

Always "model".

integer

Unix timestamp. MonoRelay uses a static value when the upstream provider does not return one.

string

The provider or organization that owns the model, as reported by the upstream provider.

The model list is built from all enabled providers. If a provider is disabled in config.yml, its models are excluded. Duplicate model IDs across providers are deduplicated, with the first occurrence kept.

Example

curl https://<host>/v1/models

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1710000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1710000000,
      "owned_by": "anthropic"
    }
  ]
}

GET /v1/credits

The /v1/credits endpoint returns the credit balance from the upstream provider associated with the authenticated token. This is primarily useful when using providers that expose a credits or balance API (such as OpenRouter).

GET /v1/credits

This endpoint requires authentication:

Authorization: Bearer <your-access-token>

Example

curl https://<host>/v1/credits \
  -H "Authorization: Bearer <token>"

{
  "total_credits": 10.00,
  "used_credits": 2.35,
  "remaining_credits": 7.65
}

The exact fields returned depend on what the upstream provider exposes. MonoRelay passes the response through without modification.

Auto-generate your docs

Overview

OpenAI-Compatible

Anthropic-Compatible

Management API

GET /v1/models — list models from all enabled providers

Method and path

Request body

Response

Example

GET /v1/credits

Example

​Method and path

​Request body

​Response

​Example

​GET /v1/credits

​Example

Method and path

Request body

Response

Example

GET /v1/credits

Example