---
title: "Model"
description: "a model: the task it decides, its kind, its address, its calibration, its state"
section: concepts
address: /concepts/model
contract: 0476e35e6e275db5
---

# Model

a model: the task it decides, its kind, its address, its calibration, its state

[figure: Model is a row at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | row |
| scope | platform |
| key | its name and version |
| store | postgres |
| family | models |



## Fields


| field | type | required | note |
|---|---|---|---|
| `name` | `text` | yes |  |
| `version` | `text` | yes |  |
| `task` | `text` | yes | in one sentence |
| `kind` | `one of classifier \| embedder \| estimator \| generator \| normaliser \| chunker \| language head \| quality head \| near-duplicate method \| pooling recipe \| probe` | yes |  |
| `width` | `count` | no | for an embedder |
| `address` | `address` | yes | with no default |
| `provider` | `text` | yes | who serves it; the settings name the provider's key by its environment name |
| `leaves_the_platform` | `bool` | yes | whether text sent to it leaves the platform |
| `price_per_million_prompt_tokens` | `money` | no | the list price the provider states |
| `price_per_million_completion_tokens` | `money` | no | the list price the provider states; none for an embedder |
| `longest_input` | `count` | no | tokens |
| `prefix` | `text` | no | the prefix the model expects before a query, if any |
| `licence` | `text` | no |  |
| `known_examples` | `[id]` | yes |  |
| `controls` | [ControlResult](/concepts/controlresult) | yes |  |
| `statistics` | [ModelStatistics](/concepts/modelstatistics) | no |  |
| `cost_per_call` | [Cost](/concepts/cost) | no |  |
| `state` | [Readiness](/concepts/readiness) | yes |  |
| `life` | `one of candidate \| under test \| in shadow \| frozen \| serving \| retired` | yes |  |



## Routes that use it
No route takes or returns Model directly. The record holds it, and the objects that point at it reach it.