API reference

API reference · Account

Estimate a distillation from /distill

POST/api/account/distill/estimateSigned in session

As POST /v1/distill/estimate. Same origin only. A 404 at every path while the operator has not turned distillation on.

Request body

application/json, required

Request body fields
FieldTypeWhat it is
key_idrequiredintegerThe key whose captures are read. Over /v1/distill it is always the calling key. At most 9007199254740991.
teacherrequiredstringThe model whose answers are learnt: captured requests it answered with a 2xx. At most 200 characters.
base_modelrequiredstringThe base model trained: meta-llama/Meta-Llama-3.1-8B-Instruct-Reference, Qwen/Qwen3.5-9B, openai/gpt-oss-20b, Qwen/Qwen3.5-27B, meta-llama/Llama-3.3-70B-Instruct-Reference. At most 200 characters.
fromrequiredintegerThe window's start, unix seconds; the window is at most 30 days wide. From 0 to 9007199254740991.
torequiredintegerThe window's end, unix seconds. From 0 to 9007199254740991.
holdoutnumberThe newest share held out for the proof, 0.1 unless set. From 0.05 to 0.3.
epochsintegerPasses over the training set, 3 unless set. From 1 to 10.

Example

{
  "key_id": 0,
  "teacher": "string",
  "base_model": "string",
  "from": 0,
  "to": 0
}

Answer 200

The estimate.

Fields of the 200 answer
FieldTypeWhat it is
object"distill.estimate"
capturesinteger
examplesintegerTraining examples, the held out slice not among them.
holdoutinteger
duplicatesintegerRepeated prompts left out.
skippedobject
train_tokensintegerAn upper bound on one pass's tokens.
trainingobject
training.per_million_tokens_usdnumber
training.minimum_usdnumber
training.upstream_microsinteger
training.markup_bpsinteger
training.hold_microsintegerWhat is held before the upload.
readybooleanAt least 50 examples and 10 held out, inside the hold's ceiling.

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 404OpenAI shaped error.
  • 409OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter