---
title: "oz0 provider model"
description: "Describe a model of a provider record."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/provider/model"
---
# oz0 provider model

> Describe a model of a provider record.

For: Operators and developers looking up a command.

Describe a model of a provider record. Aliases match an agent's needs and min_context against these, so a model the record does not describe cannot be picked for an agent that needs something. Prices are dollars per million tokens, and per second for models priced by the time they run; they win over genai-prices. --max-output is what the gateway reserves for a call to the model that sets no output limit (128000 tokens when not given).

--effort-levels and --effort-default say which reasoning effort levels it takes and its default: a job's effort is rounded to them, and a model whose levels neither its record nor the release gives is sent none. Without --shared, a shared record is copied into the tenant's own first.

## Usage

```bash
oz0 provider model <provider> <model> [flags]
```

## Flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --cache-read
      </code>
    </td>
    
    <td>
      float
    </td>
    
    <td>
      
    </td>
    
    <td>
      dollars per million tokens read from the prompt cache
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --cache-write
      </code>
    </td>
    
    <td>
      float
    </td>
    
    <td>
      
    </td>
    
    <td>
      dollars per million tokens written to the prompt cache
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --cache-write-long
      </code>
    </td>
    
    <td>
      float
    </td>
    
    <td>
      
    </td>
    
    <td>
      dollars per million tokens written to the prompt cache with its longer lifetime
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --capabilities
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      what it can do: tools, vision, structured_output, thinking, pdf, audio, web_search, prompt_cache
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --context-window
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      its context window in tokens, such as 200000, 200k or 1m
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --effort-default
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the effort level it runs at when a call sets none
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --effort-levels
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      the reasoning effort levels it takes, of low, medium, high, xhigh, max; none for a model that takes none
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --input
      </code>
    </td>
    
    <td>
      float
    </td>
    
    <td>
      
    </td>
    
    <td>
      dollars per million input tokens
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --max-output
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      its largest output in tokens, such as 64k: what a call that sets no max_tokens is reserved for
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --output
      </code>
    </td>
    
    <td>
      float
    </td>
    
    <td>
      
    </td>
    
    <td>
      dollars per million output tokens
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --per-second
      </code>
    </td>
    
    <td>
      float
    </td>
    
    <td>
      
    </td>
    
    <td>
      dollars per second a call runs, such as a GPU's cost
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --remove
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      forget the model instead
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --retires
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the day the provider retires the model, such as 2026-12-31 (empty clears it); agents that pin it are warned before
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --shared
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      change the record every tenant sees (cluster admins)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --successor
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the model the provider names in its place, with --retires
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tenant
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        default
      </code>
    </td>
    
    <td>
      tenant
    </td>
  </tr>
</tbody>
</table>

## Inherited flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --context
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        $OZ0_CONTEXT or &lt;config dir>/orchestrator-zero/context.json
      </code>
    </td>
    
    <td>
      CLI context file written by server init
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --log-level
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        info
      </code>
    </td>
    
    <td>
      log level: debug, info, warn or error
    </td>
  </tr>
</tbody>
</table>

See [all `oz0` commands](https://docs.oz0.ai/reference/cli/oz0) and the [global flags](https://docs.oz0.ai/reference/cli/oz0#global-flags).


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.