List models

GET /api/v1/models — the Ostra models your key can call, with their tasks, limits and prices.

GEThttps://ostra.testrelic.ai/api/v1/models

Lists the models your key can call, with their tasks, limits and prices.

Use it to check a key works (any key, read-only included) and to read the live Ostra Decision release. It’s free and not rate limited.

Auth
Authorization: Bearer $OSTRA_API_KEY. Any key, read-only included.
Rate limit
Not rate limited.
Cost
Free.
Over MCP
Same operation as the ostra_list_models tool.
curl https://ostra.testrelic.ai/api/v1/models \
  -H "Authorization: Bearer $OSTRA_API_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "ostra-lite",
      "name": "Ostra Decision",
      "status": "beta",
      "release": "v.beta.5",
      "tasks": [
        {
          "task": "triage",
          "name": "Failure triage",
          "description": "Classifies a failing test as flaky, product bug, test bug, environment or selector drift.",
          "mcpTool": "ostra_triage_failure",
          "rateLabel": "$0.50 / 1M failures",
          "outputRateLabel": "$0.00 / 1M decisions",
          "version": "1.4.0",
          "contentHash": "sha256:3f9a1c07d2e4b8a6",
          "gatePassed": true,
          "classes": [
            "flaky",
            "product_bug",
            "test_bug",
            "environment",
            "selector_drift"
          ],
          "deferThreshold": 0.6
        },
        {
          "task": "test_impact",
          "name": "Test impact",
          "description": "Ranks candidate tests by the probability that a diff breaks them.",
          "mcpTool": "ostra_select_impacted_tests",
          "rateLabel": "$2.00 / 1M diffs",
          "outputRateLabel": "$0.00 / 1M decisions",
          "version": "1.1.2",
          "contentHash": "sha256:a07be3315c9d4f12",
          "gatePassed": true,
          "classes": [
            "not_impacted",
            "impacted"
          ],
          "deferThreshold": 0.55
        },
        {
          "task": "selector_survival",
          "name": "Selector survival",
          "description": "Predicts whether UI locators survive the next release.",
          "mcpTool": "ostra_check_selector",
          "rateLabel": "$0.25 / 1M selectors",
          "outputRateLabel": "$0.00 / 1M decisions",
          "version": "1.2.0",
          "contentHash": "sha256:5d21f0e9c4a7b3e8",
          "gatePassed": true,
          "classes": [
            "survives",
            "breaks"
          ],
          "deferThreshold": 0.6
        }
      ],
      "pricing": {
        "input": "$0.25–$2.00 / 1M inputs",
        "output": "$0.00 / 1M decisions"
      },
      "latencyP50Ms": 41,
      "requests7d": 1284
    },
    {
      "id": "ostra-pro",
      "object": "model",
      "created": 1794873600,
      "owned_by": "testrelic",
      "name": "Ostra Pro",
      "version": "1.0",
      "base_url": "https://ostra.testrelic.ai/api/v1",
      "context_window": 262144,
      "max_output_tokens": 32768,
      "pricing": {
        "input": "$0.64 / 1M input tokens",
        "cached_input": "$0.06 / 1M cached input tokens",
        "output": "$4.47 / 1M output tokens"
      },
      "mcp_tool": "ostra_pro_chat"
    }
  ]
}

Request body

No body.

Response

  • objectstring

    Always list.

    Valuelist
  • dataarray of objects

    One entry per model: Ostra Decision, then Ostra Pro.

    Show 16 child fields
    • idstring

      Model id to send as model: ostra-lite (Ostra Decision) or ostra-pro (Ostra Pro).

    • namestring

      Display name: Ostra Decision or Ostra Pro.

    • statusstring

      Ostra Decision only: beta.

    • releasestring

      Ostra Decision only: the live release, e.g. v.beta.5, or unavailable if it can’t be reached right now.

    • tasksarray of objects

      Ostra Decision only: its three tasks.

      Show 11 child fields
      • taskstring

        Task id to send as task.

        One oftriagetest_impactselector_survival
      • namestring

        Display name.

      • descriptionstring

        What the task answers.

      • mcpToolstring

        The MCP tool that runs this task.

      • rateLabelstring

        Input price, e.g. $0.50 / 1M failures.

      • outputRateLabelstring

        Output price (always $0.00).

      • versionstring

        Version of this task’s model in the live release.

      • contentHashstring

        Content hash of that model.

      • gatePassedboolean

        The model passed its release quality gate.

      • classesarray of strings

        The classes the task can answer.

      • deferThresholdnumber

        The task’s default confidence bar for a firm answer. A class can use a different bar; each answer reports the one it used in threshold.

    • pricingmap of strings

      Human-readable prices: input, output, and for Ostra Pro cached_input.

    • latencyP50Msnumber or null

      Ostra Decision only: your workspace’s median latency over 7 days.

    • requests7dinteger

      Ostra Decision only: your workspace’s requests over 7 days.

    • objectstring

      Ostra Pro only: model.

    • createdinteger

      Ostra Pro only: Unix time the model version was released.

    • owned_bystring

      Ostra Pro only: testrelic.

    • versionstring

      Ostra Pro only: 1.0.

    • base_urlstring

      Ostra Pro only: base URL for OpenAI-compatible clients.

    • context_windowinteger

      Ostra Pro only: 262,144 tokens.

    • max_output_tokensinteger

      Ostra Pro only: 32,768 tokens.

    • mcp_toolstring

      Ostra Pro only: ostra_pro_chat.

Response headers

  • x-request-idstring

    Id of this request (req_ + 26 characters). Quote it to support.

Errors

StatusTypeWhen
401authentication_errorThe API key is missing, malformed, unknown, revoked or expired.
403permission_errorThe caller’s IP isn’t in the key’s allowlist.

Every error has the same envelope and a request_id. See Errors for messages and retry advice.

Was this page helpful?