Axon Model API Reference | MatterAI Documentation

Get Model

curl --request GET \
  --url https://api.matterai.so/v1/models/:model_id

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.matterai.so/v1/models/:model_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.matterai.so/v1/models/:model_id"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.matterai.so/v1/models/:model_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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>"
  }
}

GET

models

:model_id

Get Model

curl --request GET \
  --url https://api.matterai.so/v1/models/:model_id

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.matterai.so/v1/models/:model_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.matterai.so/v1/models/:model_id"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.matterai.so/v1/models/:model_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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

string

required

The ID of the model to retrieve.

Response

string

The model identifier.

string

The model name.

string

A description of the model.

string

The object type, which is always "model".

array

The input modalities supported by the model.

integer

The maximum context length for the model.

integer

The maximum output length for the model.

array

The output modalities supported by the model.

array

The sampling parameters supported by the model.

array

The features supported by the model.

object

OpenRouter integration details.

Show OpenRouter Object

string

The OpenRouter slug for the model.

array

The datacenters where the model is available.

Show Datacenter Object

string

The country code of the datacenter.

integer

The Unix timestamp (in seconds) of when the model was created.

string

The organization that owns the model.

object

Pricing information for the model.

Show Pricing Object

string

The price per prompt token.

string

The price per completion token.

string

The price per image.

string

The price per request.

string

The price for input cache reads.

string

The price for input cache writes.

Example Request

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

const response = await fetch('https://api.matterai.so/v1/models/axon-code', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer MATTERAI_API_KEY'
  }
});

const data = await response.json();
console.log(data);

import requests

url = "https://api.matterai.so/v1/models/axon-code"
headers = {
    "Authorization": "Bearer MATTERAI_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

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:

Unauthorized

Invalid or missing API key.

Not Found

The requested model was not found.

Rate Limited

Too many requests. Please slow down.

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"
  }
}

​Authentication

​Request

​Path Parameters

​Response

​Example Request

​Example Response

​Error Responses

Authentication

Request

Path Parameters

Response

Example Request

Example Response

Error Responses