Skip to main content
POST
Score query/document pairs

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Body

application/json
queries
required
documents
required
model
string | null
user
string | null
truncate_prompt_tokens
integer | null
Required range: x >= -1
truncation_side
enum<string> | null

Which side to truncate from when truncate_prompt_tokens is active. 'right' keeps the first N tokens. 'left' keeps the last N tokens.

Available options:
left,
right
request_id
string | null

The request_id related to this request. If the caller does not set it, a random uuid will be generated.

priority
integer
default:0

The priority of the request (lower means earlier handling; default: 0). Any priority other than 0 will raise an error if the served model does not use priority scheduling.

mm_processor_kwargs
Mm Processor Kwargs · object | null

Additional kwargs to pass to the HF processor.

cache_salt
string | null

If specified, the prefix cache will be salted with the provided string to prevent an attacker from guessing prompts in multi-user environments.

use_activation
boolean | null

Whether to use activation for the pooler outputs. null uses the pooler's default, which is true in most cases.

max_tokens_per_query
integer
default:0

Maximum number of tokens per query. Queries longer than this will be truncated. 0 means no query-level truncation is applied.

max_tokens_per_doc
integer
default:0

Maximum number of tokens per document. Documents longer than this will be truncated. 0 means no document-level truncation is applied (only truncate_prompt_tokens applies to the combined query+document).

instruction
string | null

Task instruction prepended to each scored pair via the chat template. Equivalent to passing chat_template_kwargs={'instruction': ...}.

chat_template_kwargs
Chat Template Kwargs · object | null

Additional keyword args to pass to the chat template renderer. Will be accessible by the score/rerank chat template.

Response

Successful response.

id
string
required
created
integer
required
model
string
required
data
ScoreResponseData · object[]
required
usage
UsageInfo · object
required
object
string
default:list
Last modified on July 31, 2026