API reference

API reference · API

Light the distilled world

POST/v1/distill/{id}/lightAPI key

Chat scope. The hardware the model needs is priced at the provider's published hourly price for one replica, marked up; the hours are held on the funded balance, then the replica starts. Requests to the world carry no token charge. It is charged for the minutes it ran when it goes dark. keep_lit holds one more hour each hour. A 404 at every path while the operator has not turned distillation on.

Parameters

Path and query parameters
FieldTypeWhat it is
id (path)requiredstring

Request body

application/json, optional

Request body fields
FieldTypeWhat it is
hoursintegerHours held and lit, 1 unless set. From 1 to 9007199254740991.
keep_litbooleanHold one more hour each hour until put out or the balance cannot hold it.

Example

{
  "hours": 1,
  "keep_lit": false
}

Answer 200

The distillation, its world lighting.

Fields of the 200 answer
FieldTypeWhat it is
idstring
object"distill.job"
worldstringantimatter/distilled/<id>, nameable by the owner's keys only.
teacherstring
base_modelstring
statusanyOne of "uploading", "validating", "training", "completed", "failed", "cancelled".
trainingobject
lossarray of object
loss[].kindanyOne of "train", "eval".
loss[].stepinteger
loss[].lossnumber
world_stateobject
world_state.stateanyOne of "dark", "lighting", "lit", "darkening".
world_state.hourly_microsinteger or null
world_state.untilinteger or null
world_state.spent_microsinteger
proofobject or nullAgreement on the held out slice with its 95% Wilson interval, latency beside the teacher's, and a request's cost before and after at the key's own rate.

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 402OpenAI shaped error.
  • 404OpenAI shaped error.
  • 409OpenAI shaped error.
  • 502OpenAI 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