# Models

## List models

`$ openai models list`

**get** `/models`

Lists the currently available models, and provides basic information about each one such as the owner and availability.

### Returns

- `ListModelsResponse: object { data, object }`

  - `data: array of Model`

    - `id: string`

      The model identifier, which can be referenced in the API endpoints.

    - `created: number`

      The Unix timestamp (in seconds) when the model was created.

    - `object: "model"`

      The object type, which is always "model".

    - `owned_by: string`

      The organization that owns the model.

  - `object: "list"`

### Example

```cli
openai models list \
  --api-key 'My API Key'
```

#### Response

```json
{
  "data": [
    {
      "id": "id",
      "created": 0,
      "object": "model",
      "owned_by": "owned_by"
    }
  ],
  "object": "list"
}
```

## Retrieve model

`$ openai models retrieve`

**get** `/models/{model}`

Retrieves a model instance, providing basic information about the model such as the owner and permissioning.

### Parameters

- `--model: string`

  The ID of the model to use for this request

### Returns

- `model: object { id, created, object, owned_by }`

  Describes an OpenAI model offering that can be used with the API.

  - `id: string`

    The model identifier, which can be referenced in the API endpoints.

  - `created: number`

    The Unix timestamp (in seconds) when the model was created.

  - `object: "model"`

    The object type, which is always "model".

  - `owned_by: string`

    The organization that owns the model.

### Example

```cli
openai models retrieve \
  --api-key 'My API Key' \
  --model gpt-4o-mini
```

#### Response

```json
{
  "id": "id",
  "created": 0,
  "object": "model",
  "owned_by": "owned_by"
}
```

## Delete a fine-tuned model

`$ openai models delete`

**delete** `/models/{model}`

Delete a fine-tuned model. You must have the Owner role in your organization to delete a model.

### Parameters

- `--model: string`

  The model to delete

### Returns

- `model_deleted: object { id, deleted, object }`

  - `id: string`

  - `deleted: boolean`

  - `object: string`

### Example

```cli
openai models delete \
  --api-key 'My API Key' \
  --model ft:gpt-4o-mini:acemeco:suffix:abc123
```

#### Response

```json
{
  "id": "id",
  "deleted": true,
  "object": "object"
}
```

## Domain Types

### Model

- `model: object { id, created, object, owned_by }`

  Describes an OpenAI model offering that can be used with the API.

  - `id: string`

    The model identifier, which can be referenced in the API endpoints.

  - `created: number`

    The Unix timestamp (in seconds) when the model was created.

  - `object: "model"`

    The object type, which is always "model".

  - `owned_by: string`

    The organization that owns the model.

### Model Deleted

- `model_deleted: object { id, deleted, object }`

  - `id: string`

  - `deleted: boolean`

  - `object: string`