Agents

List agent models (Preview)

Preview · Available to selected organizations. Returns the models an agent can run on: the standard and max aliases, each with the model it points at today, then every catalog model an agent can pin.

GET
/v1/agents/models

Returns the models an agent can run on: the standard and max aliases, each with the model it points at today, then every catalog model an agent can pin. Each entry has its price per million tokens, the reasoning levels it accepts with an estimate of a typical reply at each, and whether your plan includes it. Pinning a catalog model needs the Growth or Scale plan.

Authorization

apiKey
headerx-api-key<token>

Response Body

AgentModelCatalog

application/json
  1. response
replyFeeDollars*number
items*array<>
Example Request
import { createClient } from "samva";const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });const result = await samva.agents.listModels({});
Example Response
{  "replyFeeDollars": 0,  "items": [    {      "id": "standard",      "name": "string",      "alias": true,      "model": {        "id": "string",        "name": "string"      },      "contextWindow": -9007199254740991,      "inputModalities": [        "string"      ],      "price": {        "inputPerMillionDollars": 0,        "outputPerMillionDollars": 0,        "cacheReadPerMillionDollars": 0,        "cacheWritePerMillionDollars": 0      },      "reasoning": [        {          "level": "auto",          "typicalReplyDollars": 0        }      ],      "access": "included"    }  ]}

Related documentation