---
title: "POST /v1/score/{model}"
method: POST
path: "/v1/score/{model}"
tags: ["inference"]
---

# POST /v1/score/{model}

`POST /v1/score/{model}`

Mixed-success batches return 200 with only successful items; the response carries no per-item error envelope. For per-item error visibility, send single-item batches.

## Path parameters

- `model` string, required

## Headers

- `X-SIE-MACHINE-PROFILE` string, nullable
- `X-SIE-Pool` string, nullable
- `X-SIE-SDK-Version` string, nullable

## Request body

- ScoreRequest
  - `instruction` string, nullable
  - `items` ItemInput[], required
    - `audio` AudioInput
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
      - `sample_rate` integer, nullable — Sample rate in Hz. Must be positive.
    - `document` DocumentInput
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
    - `id` string, nullable
    - `images` ImageInput[], nullable
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
    - `metadata` unknown
    - `text` string, nullable
    - `video` VideoInput
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
  - `options` unknown
  - `query` ItemInput, required
    - `audio` AudioInput
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
      - `sample_rate` integer, nullable — Sample rate in Hz. Must be positive.
    - `document` DocumentInput
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
    - `id` string, nullable
    - `images` ImageInput[], nullable
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable
    - `metadata` unknown
    - `text` string, nullable
    - `video` VideoInput
      - `data` string, byte, required — Media bytes. Base64-encoded on the JSON path; native binary on the msgpack path.
      - `format` string, nullable

## Response `200`

Score response

- ScoreResponse
  - `model` string, required
  - `query_id` string, nullable
  - `scores` ScoreEntry[], required
    - `item_id` string, required
    - `rank` integer, required
    - `score` number, double, required
  - `usage` ScoreUsage
    - `images` integer, nullable
    - `input_tokens` integer, required

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid bearer token
- `404` — Model not found
- `409` — Bundle override conflicts with model routing
- `413` — Request body too large
- `500` — All batch items failed or gateway internal error; gateway auth enabled but no tokens configured
- `502` — Terminal model load failure (MODEL_LOAD_FAILED)
- `503` — Provisioning in progress, queue unavailable, GPU not configured, model loading, or capacity exhausted
- `504` — Result channel closed

## Changes

- **2026-08-27** `78eeecd83405` — 20 breaking, 28 info
  - the `items/items/document/oneOf[#/components/schemas/DocumentInput]/data` request property contentEncoding changed from `` to `base64` (media type: application/json)
  - the `items/items/document/oneOf[#/components/schemas/DocumentInput]/data` request property contentEncoding changed from `` to `base64` (media type: application/msgpack)
  - the `items/items/document/oneOf[#/components/schemas/DocumentInput]/data` request property contentEncoding changed from `` to `base64` (media type: application/vnd.msgpack)
  - the `items/items/document/oneOf[#/components/schemas/DocumentInput]/data` request property contentEncoding changed from `` to `base64` (media type: application/x-msgpack)
  - …44 more
- **2026-07-22** `9f3153c32a93` — 4 info
  - added the optional property `usage` to the response with the `200` status (media type: application/json)
  - added the optional property `usage` to the response with the `200` status (media type: application/msgpack)
  - added the optional property `usage` to the response with the `200` status (media type: application/vnd.msgpack)
  - added the optional property `usage` to the response with the `200` status (media type: application/x-msgpack)
- **2026-07-03** `a07e76b98502` — 1 warning
  - deleted the `header` request parameter `X-SIE-Engine`
- **2026-06-13** `a7b0c412cdd4` — 1 breaking
  - removed the success response with the status `202`
- …earlier changes not shown

[Full history](https://skmtc.dev/superlinked/apis/sie-gateway/changes/v1/score/:model/post.md)

---

[API](https://skmtc.dev/superlinked/apis/sie-gateway.md) · [All operations](https://skmtc.dev/superlinked/apis/sie-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superlinked/sie-gateway/revisions/78eeecd83405/schema)