Models

List the model catalog and read a single model entry.

List modelsPermalink to List models

GET/v1/models

Returns the active catalog as a list object.

Authentication: Optional

Do not hardcode model identifiers

The catalog is served live and changes without a documentation release. Read it at runtime and select from what the endpoint actually returns — a list copied into your code will drift out of date without failing loudly.

Response shapePermalink to Response shape

The response is a list object whose data array holds one entry per available model.

Response envelope, with field names as returned

{
  "object": "list",
  "data": [
    {
      "id": "<model id>",
      "name": "<display name>",
      "min_tier": "<tier required>",
      "max_tokens": 0,
      "context_window": 0,
      "supports_images": false,
      "supports_caching": false,
      "supports_reasoning": false,
      "supports_global_endpoint": false,
      "input_price": 0,
      "output_price": 0,
      "cache_write_price": 0,
      "cache_read_price": 0,
      "description": "<description>",
      "api_format": "<format>",
      "is_featured": false,
      "credit_tier": "<tier>"
    }
  ]
}

Field	Type	Meaning
id	string	The identifier to send as model in a chat-completions request.
name	string	Human-readable display name.
min_tier	string	The account tier required before this entry can be used.
max_tokens	integer	Maximum tokens the model will generate in one response. Omitted when unpublished.
context_window	integer	Maximum combined input plus output length. Omitted when unpublished.
supports_images	boolean	Whether image parts are accepted in message content.
supports_caching	boolean	Whether prompt caching applies.
supports_reasoning	boolean	Whether the model exposes reasoning behaviour.
input_price	number	Price per input unit. Omitted when unpublished.
output_price	number	Price per output unit. Omitted when unpublished.
cache_write_price	number	Price per cached-write unit. Omitted when unpublished.
cache_read_price	number	Price per cached-read unit. Omitted when unpublished.
description	string	Free-text description. Omitted when empty.
temperature	number	Default sampling temperature for this entry. Omitted when unset.
api_format	string	The request format this entry expects. Omitted when unset.
supports_global_endpoint	boolean	Whether the entry is reachable on the global endpoint.
thinking_config	object	Reasoning configuration block. Omitted when the entry has none.
tiers	object	Per-tier metadata block. Omitted when the entry has none.
is_featured	boolean	Whether the entry is featured in catalog listings.
featured_label	string	Label shown when featured. Omitted otherwise.
featured_tab	string	Grouping tab used when featured. Omitted otherwise.
display_order	integer	Sort position in the catalog. Omitted when unset.
credit_tier	string	Credit band the entry bills against. Omitted when unset.

Every field the catalog returns. The list is complete as of the pinned backend commit — nothing is omitted for brevity, because a field a caller can see and cannot look up is worse than one that does not exist.

A catalog entry names the model and nothing behind it

Do not build routing or display logic that expects a field naming the service that serves a model. The backend removes it from the customer response deliberately, so it will never appear.

Optional fields may be absent

Fields marked optional in the catalog are omitted rather than sent as null when they have no value. Check for presence before reading them.

ExamplesPermalink to Examples

curl — list the catalog

"tk-cmd">curl https://api.relane.ai/v1/models \
  "tk-flag">-H "Authorization: Bearer rl_sk_live_YOUR_KEY"

JavaScript — pick a model that accepts images

const res = await fetch(class="tk-str">"https:class="tk-commentclass="tk-str">">//api.relane.ai/v1/models", {
  headers: { Authorization: class="tk-str">`Bearer ${process.env.RELANE_API_KEY}` },
});
const { data } = await res.json();

const withImages = data.filter((m) => m.supports_images);
if (withImages.length === 0) {
  throw new Error(class="tk-str">"no image-capable model is available to this key");
}
const modelId = withImages[0].id;

Read one modelPermalink to Read one model

GET/v1/models/{model_id}

Returns a single catalog entry.

Authentication: Optional

curl

"tk-cmd">curl https://api.relane.ai/v1/models/MODEL_ID \
  "tk-flag">-H "Authorization: Bearer rl_sk_live_YOUR_KEY"