Skip to main content
GET
/
v1
/
models
/
:model_id
Get Model
curl --request GET \
  --url https://api.matterai.so/v1/models/:model_id
{
  "401": {},
  "404": {},
  "429": {},
  "500": {},
  "model_id": "<string>",
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "object": "<string>",
  "input_modalities": [
    {}
  ],
  "context_length": 123,
  "max_output_length": 123,
  "output_modalities": [
    {}
  ],
  "supported_sampling_parameters": [
    {}
  ],
  "supported_features": [
    {}
  ],
  "openrouter": {
    "slug": "<string>"
  },
  "datacenters": [
    {
      "country_code": "<string>"
    }
  ],
  "created": 123,
  "owned_by": "<string>",
  "pricing": {
    "prompt": "<string>",
    "completion": "<string>",
    "image": "<string>",
    "request": "<string>",
    "input_cache_reads": "<string>",
    "input_cache_writes": "<string>"
  }
}

​
Authentication

All API requests require authentication using a Bearer token. You can obtain your API key from the MatterAI Console. 
Authorization: Bearer MATTERAI_API_KEY
Keep your API key secure and never expose it in client-side code. Get your API key from the MatterAI console.

​
Request

​
Path Parameters

​
model_id
string
required
The ID of the model to retrieve.

​
Response

​
id
string
The model identifier.
​
name
string
The model name.
​
description
string
A description of the model.
​
object
string
The object type, which is always "model".
​
input_modalities
array
The input modalities supported by the model.
​
context_length
integer
The maximum context length for the model.
​
max_output_length
integer
The maximum output length for the model.
​
output_modalities
array
The output modalities supported by the model.
​
supported_sampling_parameters
array
The sampling parameters supported by the model.
​
supported_features
array
The features supported by the model.
​
openrouter
object
OpenRouter integration details.
​
datacenters
array
The datacenters where the model is available.
​
created
integer
The Unix timestamp (in seconds) of when the model was created.
​
owned_by
string
The organization that owns the model.
​
pricing
object
Pricing information for the model.

​
Example Request

curl --location 'https://api.matterai.so/v1/models/axon-code' \
--header 'Authorization: Bearer MATTERAI_API_KEY'

​
Example Response

{
  "id": "axon-code",
  "name": "Axon Code",
  "description": "Axon Code is super intelligent LLM model for coding tasks",
  "object": "model",
  "input_modalities": [
    "text"
  ],
  "context_length": 256000,
  "max_output_length": 32768,
  "output_modalities": [
    "text"
  ],
  "supported_sampling_parameters": [
    "temperature",
    "top_p",
    "top_k",
    "repetition_penalty",
    "frequency_penalty",
    "presence_penalty",
    "seed",
    "stop"
  ],
  "supported_features": [
    "tools",
    "structured_outputs",
    "web_search"
  ],
  "openrouter": {
    "slug": "matterai/axon"
  },
  "datacenters": [
    {
      "country_code": "US"
    }
  ],
  "created": 1750426201,
  "owned_by": "matterai",
  "pricing": {
    "prompt": "0.000001",
    "completion": "0.000004",
    "image": "0",
    "request": "0",
    "input_cache_reads": "0",
    "input_cache_writes": "0"
  }
}

​
Error Responses

The API returns standard HTTP status codes to indicate success or failure:
​
401
Unauthorized
Invalid or missing API key.
​
404
Not Found
The requested model was not found.
​
429
Rate Limited
Too many requests. Please slow down.
​
500
Internal Server Error
Server error. Please try again later.
Example error response: 
{
  "error": {
    "message": "Model not found",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}