Skip to content
Cemented.ai
Get started
API Reference
Models

List available grounded models

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
data: array of object { id, created, object, 8 more }
id: string

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

created: number
object: "model"
owned_by: string
_maps_to: optional string

Underlying Anthropic Claude model used by the pipeline.

context_length: optional number

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

grounded: optional boolean

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

max_output_tokens: optional number

Maximum tokens the model will generate in one response.

search_providers: optional array of string

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

supports_streaming: optional boolean
supports_tools: optional boolean

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

object: "list"

List available grounded models

curl https://www.cemented.ai/v1/models \
    -H "Authorization: Bearer $CEMENTED_AI_API_KEY"
{
  "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
{
  "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"
}