List available models | Mesh API Docs

curl https://api.meshapi.ai/v1/models \
     -H "Authorization: Bearer <token>"

[
  {
    "id": "openai/gpt-4o-mini",
    "name": "GPT-4o Mini",
    "is_free": false,
    "pricing": {
      "prompt_usd_per_1k": "0.00015000",
      "completion_usd_per_1k": "0.00060000",
      "discount_pct": "10.0",
      "prompt_usd_per_1k_discounted": "0.00013500",
      "completion_usd_per_1k_discounted": "0.00054000"
    },
    "context_length": 128000,
    "description": "Lightweight multimodal model for fast chat completions."
  },
  {
    "id": "meta-llama/llama-3.1-8b-instruct:free",
    "name": "Llama 3.1 8B Instruct (Free)",
    "is_free": true,
    "pricing": {
      "prompt_usd_per_1k": "0",
      "completion_usd_per_1k": "0"
    },
    "context_length": 131072,
    "description": "Free-tier text model available for low-cost experimentation."
  }
]

Returns the models enabled for the authenticated owner.

The backend joins the model registry with the default pricing table and, for paid models, enriches prices with any active owner-level discount.

Authentication accepts either:

a data-plane Mesh API key (rsk_...)
a control-plane bearer token used by the dashboard

Returns the models enabled for the authenticated owner. The backend joins the model registry with the default pricing table and, for paid models, enriches prices with any active owner-level discount. Authentication accepts either: - a data-plane Mesh API key (`rsk_...`) - a control-plane bearer token used by the dashboard

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

freebooleanOptional

Optional cost-tier filter.

true: free models only
false: paid models only
omitted: all enabled models

Optional cost-tier filter. - `true`: free models only - `false`: paid models only - omitted: all enabled models

Response

List of enabled models.

idstring

namestring

is_freeboolean

pricingobject

context_lengthinteger or null

descriptionstring or null

Errors

401

Unauthorized Error

403

Forbidden Error