API Reference

Models

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List available grounded models

client.models.list(RequestOptionsoptions?): ModelListResponse { data, object }

GET/v1/models

Returns the OpenAI-compatible model list plus capability metadata so callers can choose a model programmatically. _maps_to exposes the underlying Anthropic Claude model the grounded pipeline runs on.

ReturnsExpand Collapse

ModelListResponse { data, object }

data: Array<Data>

id: string

Pass this as model on /v1/responses (e.g. "grounded-sonnet").

created: number

object: "model"

owned_by: string

_maps_to?: string

Underlying Anthropic Claude model used by the pipeline.

context_length?: number

Maximum input + output tokens the model accepts in a single request.

grounded?: boolean

Always true — every response is grounded in retrieved sources with inline citations.

max_output_tokens?: number

Maximum tokens the model will generate in one response.

search_providers?: Array<string>

Search backends configured for the deployment (e.g. ["exa", "perplexity"]).

supports_streaming?: boolean

supports_tools?: boolean

Whether the model exposes OpenAI-style tool_use events. Currently always false; grounded search runs internally.

object: "list"

List available grounded models

TypeScript

HTTP

TypeScript

import CementedAI from 'cemented.ai';

const client = new CementedAI({
  apiKey: process.env['CEMENTED_AI_API_KEY'], // This is the default and can be omitted
});

const models = await client.models.list();

console.log(models.data);

200 example

{
  "data": [
    {
      "id": "id",
      "created": 0,
      "object": "model",
      "owned_by": "owned_by",
      "_maps_to": "_maps_to",
      "context_length": 0,
      "grounded": true,
      "max_output_tokens": 0,
      "search_providers": [
        "string"
      ],
      "supports_streaming": true,
      "supports_tools": true
    }
  ],
  "object": "list"
}

Returns Examples

200 example

{
  "data": [
    {
      "id": "id",
      "created": 0,
      "object": "model",
      "owned_by": "owned_by",
      "_maps_to": "_maps_to",
      "context_length": 0,
      "grounded": true,
      "max_output_tokens": 0,
      "search_providers": [
        "string"
      ],
      "supports_streaming": true,
      "supports_tools": true
    }
  ],
  "object": "list"
}