Models

Test Model

Tests a model by sending a simple prompt and reporting pass/fail.

post/api/v1/models/{id}/test

Path parameters

idstring required

The canonical model ID or an alias.

Query parameters

providerstring

LLM provider identifier.

Example:anthropic

Pin the test to this provider's offering. When omitted, the server selects among ready providers by catalog priority.

mode'basic' | 'deep'

Single-model test mode.

Test mode for the single-model test endpoint. Defaults to basic.

reasoning_effort'low' | 'medium' | 'high' | 'xhigh' | 'max'

Native reasoning-effort level requested for an LLM call.

Optional native reasoning-effort level for the model test.

Response

Test result

model_idstring required

The canonical model ID that was tested.

providerstring required

LLM provider identifier.

status'ok' | 'error' | 'skip' required

Whether the model responded successfully, failed, or was skipped because its provider is not configured.

error_messagestring nullable

Error details when status is "error".

Example response

{
  "model_id": "claude-opus-4-6",
  "provider": "anthropic"
}

Changes

Changed in 4 of the 134 revisions of this API.115

    • added the new optional query request parameter reasoning_effort

      new-optional-request-parameter

    • added the new optional query request parameter provider

      new-optional-request-parameter

    • added the required property provider to the response with the 200 status

      response-required-property-added

  • ea20de899fa911See the full diff
    • removed the required property provider from the response with the 200 status

      response-required-property-removed

    • deleted the query request parameter provider

      request-parameter-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new optional query request parameter provider

      new-optional-request-parameter

    • added the required property provider to the response with the 200 status

      response-required-property-added