Preview Classifier

POST

https://api-gateway.merge.dev/v1/classifiers/:classifier_id/preview

POST

/v1/classifiers/:classifier_id/preview

curl -X POST https://api-gateway.merge.dev/v1/classifiers/classifier_id/preview \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "prompts": [
    "Send me the Q3 ARR waterfall file.",
    "Fix the ARR bridge so it ties to GAAP."
  ]
}'

{
  "results": [
    {
      "band": "simple",
      "generic_band": "moderate",
      "generic_readout_score": 0.52,
      "generic_score": 0.46,
      "prompt": "Send me the Q3 ARR waterfall file.",
      "readout_score": 0.18,
      "score": 0.38
    },
    {
      "band": "complex",
      "generic_band": "moderate",
      "generic_readout_score": 0.9,
      "generic_score": 0.43,
      "prompt": "Fix the ARR bridge so it ties to GAAP.",
      "readout_score": 0.71,
      "score": 0.62
    }
  ]
}

Score up to 20 prompts with the classifier and the built-in scorer, side by side. Nothing is stored and no model is called. Request-time scores can differ slightly from these.

Authentication

AuthorizationBearer

A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.

Path parameters

classifier_idstringRequiredformat: "uuid"

The classifier’s id.

Request

This endpoint expects an object.

promptslist of stringsRequired

1 to 20 prompts, each up to 50,000 characters.

Response

Each prompt's scores

resultslist of objects

One entry per prompt.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error