---
title: "Test Model"
method: POST
path: "/api/v1/models/{id}/test"
tags: ["Models"]
---

# Test Model

`POST /api/v1/models/{id}/test`

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

## Path parameters

- `id` string, required

## Query parameters

- `provider` string — LLM provider identifier.
- `mode` 'basic' | 'deep' — Single-model test mode.

## Response `200`

Test result

- ModelTestResult — Result of testing a model in `basic` or `deep` mode.
  - `model_id` string, required — The canonical model ID that was tested.
  - `provider` string, 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_message` string, nullable — Error details when status is "error".

## Other responses

- `400` — Invalid test mode
- `404` — Model not found

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/versions/bee030053823/schema)