Skip to main content
POST
/
models
/
{handle}
/
compare
cURL
curl https://u22a8.ai/v1/models/u22a8.commit-message/compare \
  -H "Authorization: Bearer $U22A8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"a": "fix bug", "b": "Fix race condition in worker dispatch by draining the in-flight queue before shutdown"}'
{
  "a": {
    "scores": {},
    "composite": 123,
    "confidence": "moderate",
    "headroom": 123,
    "detail": {},
    "input_tokens": 0,
    "metadata": {
      "request_id": "<string>",
      "version_id": "v37",
      "sample_ids": [
        123
      ]
    }
  },
  "b": {
    "scores": {},
    "composite": 123,
    "confidence": "moderate",
    "headroom": 123,
    "detail": {},
    "input_tokens": 0,
    "metadata": {
      "request_id": "<string>",
      "version_id": "v37",
      "sample_ids": [
        123
      ]
    }
  },
  "improvement": 123,
  "per_trait": {}
}

Documentation Index

Fetch the complete documentation index at: https://u22a8-police-sweep-2026-06-01.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Scores a baseline a against a candidate b and returns the per-trait delta plus the overall improvement (b.composite − a.composite). URLs in a and b are auto-fetched. Set Accept: text/plain for a side-by-side rendering.

Authorizations

​
Authorization
string
header
required

API key issued in the platform console, sent as Authorization: Bearer <key>.

Path Parameters

​
handle
string
required

Model handle, e.g. 'u22a8.technical-writing'.

Example:

"u22a8.technical-writing"

Body

application/json
​
a
string
required

Baseline text or URL.

​
b
string
required

Candidate text or URL.

​
traits
string[] | null

Score only these traits. Omit to score all.

Response

Successful Response

​
a
ScoreResponse · object
required
​
b
ScoreResponse · object
required
​
improvement
integer
required

b.composite − a.composite, in points.

​
per_trait
Per Trait · object
required