Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Excurs1ons/MonoRelay/llms.txt

Use this file to discover all available pages before exploring further.

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.
​
object
string
Always "list".
​
data
object[]
Array of model objects, one per available model.
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.

Build docs developers (and LLMs) love

Get started for freeTalk to us