v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124782.6 KB
score

Score

Score items against a query using a reranker model.

Supports both msgpack and JSON request bodies (Content-Type header). Returns msgpack by default, JSON if Accept header requests it.

Args: model: Model name to use for scoring. http_request: FastAPI request object (for body and app state). accept: Accept header for response content negotiation. x_machine_profile: Machine profile header for routing validation.

Returns: ScoreResponse with scores sorted by relevance (descending). Format depends on Accept header: msgpack (default) or JSON.

Raises: HTTPException: 400 for invalid input or profile mismatch, 404 if model not found, 503 if not loaded.

post/v1/score/{model}

Path parameters

modelstring required

Headers

acceptstring nullable
X-SIE-MACHINE-PROFILEstring nullable

Request body

instructionstring nullable

Optional scoring instruction

Example request

{
  "items": [
    {
      "text": "Machine learning is a branch of AI..."
    },
    {
      "text": "The weather is nice today."
    }
  ],
  "query": {
    "text": "What is machine learning?"
  }
}

Response

Scores computed successfully

modelstring required

Model used for scoring

query_idstring nullable

Query ID (if provided)