Skip to main content
GET
/
v1
/
models
List Models
curl --request GET \
  --url https://api.matterai.so/v1/models
{
  "401": {},
  "429": {},
  "500": {},
  "object": "<string>",
  "data": [
    {
      "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

This endpoint doesn’t require any parameters.

​
Response

​
object
string
The object type, which is always "list".
​
data
array
A list of model objects.

​
Example Request

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

​
Example Response

{
  "object": "list",
  "data": [
    {
      "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"
      }
    },
    {
      "id": "axon",
      "name": "Axon",
      "description": "Axon is an general purpose super intelligent LLM model for high-effort day-to-day 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"
      }
    },
    {
      "id": "axon-mini",
      "name": "Axon Mini",
      "description": "Axon Mini is an general purpose super intelligent LLM coding model for low-effort day-to-day tasks",
      "object": "model",
      "input_modalities": [
        "text"
      ],
      "context_length": 256000,
      "max_output_length": 16384,
      "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": "2.5e-7",
        "completion": "0.000001",
        "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.
​
429
Rate Limited
Too many requests. Please slow down.
​
500
Internal Server Error
Server error. Please try again later.
Example error response: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}