Retrieve a model

GET

/models/{model}

const url = 'https://api.staging.katara.com/v1/models/example';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.staging.katara.com/v1/models/example

katara/cortex-genius and katara/cortex-smart return their row from the model list, with their x402 price and minimum_charge, or 404 model_not_found where they are not sold. Any other name is served by Katara Cortex and returns katara/cortex. With an anthropic-version header the answer is in the Anthropic shape.

Parameters

Path Parameters

model

required

string

Any model name, written as it is, slash included.

Responses

200

The model.

application/json

Any of:

object
object

object

required

katara/cortex, or an x402-only model: katara/cortex-genius or katara/cortex-smart.

string

object

required

string

Allowed value: model

created

integer

owned_by

required

string

katara

required

object

cortex

True on a row Katara Cortex serves.

boolean

providerClass

routed on a Cortex row: whichever provider or vendor Cortex picks answers.

string

contextLimit

required

Context window in tokens.

integer

capabilities

required

object

workload

string

Allowed values: chat embedding image

tools

boolean

structuredOutputs

boolean

reasoning

boolean

streaming

boolean

vision

Reads image_url parts.

boolean

audio

Reads input_audio parts.

boolean

video

Reads file parts carrying a video.

boolean

documents

Reads file parts carrying a PDF.

boolean

image_generation

Serves /v1/images/generations.

boolean

image_editing

Serves /v1/images/edits.

boolean

maxOutputTokens

integer

tool_contract

Present when tools is true.

object

tool_choice

Accepted tool_choice values.

Array<string>

Allowed values: auto none required named

max_tool_name_length

The longest tool name a candidate takes.

integer

pricing

Cortex’s price ceiling (ceiling), or the price of an x402-only model’s own model (model), in USDC base units (6 decimals) per million tokens.

object

basis

string

Allowed values: ceiling model

input_price_per_mtok

string

output_price_per_mtok

string

currency

string

decimals

The token’s decimals, as a string.

string

image_price

One image at the default size.

string

image_prices

For a model priced by size, the price of one image at each image_size.

object

key

additional properties

string

default_image_size

string

input_image_price

Each picture sent to an edit.

string

max_input_images

The most pictures one edit takes.

integer

billing_methods

Present on the x402-only models: they are sold only per request with x402.

Array<string>

Allowed values: x402

minimum_charge

The least one paid request to an x402-only model costs, in USDC base units.

string

Example

{
  "object": "model",
  "katara": {
    "capabilities": {
      "workload": "chat",
      "tool_contract": {
        "tool_choice": [
          "auto"
        ]
      }
    },
    "pricing": {
      "basis": "ceiling",
      "input_price_per_mtok": "100000",
      "output_price_per_mtok": "300000",
      "currency": "USDC",
      "decimals": "6",
      "default_image_size": "1K"
    },
    "billing_methods": [
      "x402"
    ]
  }
}

404

An x402-only model that is not sold here (model_not_found).

application/json

object

type

required

Allowed value: error

error

required

object

type

required

string

message

required

string

code

required

string

key

additional properties

any

key

additional properties

any

Example

{
  "type": "error"
}