---
title: "Get a model"
method: GET
path: "/models/{model_owner}/{model_name}"
---

# Get a model

`GET /models/{model_owner}/{model_name}`

Example cURL request:

```console
curl -s \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  https://api.replicate.com/v1/models/replicate/hello-world
```

The response will be a model object in the following format:

```json
{
  "url": "https://replicate.com/replicate/hello-world",
  "owner": "replicate",
  "name": "hello-world",
  "description": "A tiny model that says hello",
  "visibility": "public",
  "github_url": "https://github.com/replicate/cog-examples",
  "paper_url": null,
  "license_url": null,
  "run_count": 5681081,
  "cover_image_url": "...",
  "default_example": {...},
  "latest_version": {...},
}
```

The model object includes the [input and output schema](https://replicate.com/docs/reference/openapi#model-schemas) for the latest version of the model.

Here's an example showing how to fetch the model with cURL and display its input schema with [jq](https://stedolan.github.io/jq/):

```console
curl -s \
    -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
    https://api.replicate.com/v1/models/replicate/hello-world \
    | jq ".latest_version.openapi_schema.components.schemas.Input"
```

This will return the following JSON object:

```json
{
  "type": "object",
  "title": "Input",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "title": "Text",
      "x-order": 0,
      "description": "Text to prefix with 'hello '"
    }
  }
}
``` 

The `cover_image_url` string is an HTTPS URL for an image file. This can be:

- An image uploaded by the model author.
- The output file of the example prediction, if the model author has not set a cover image.
- The input file of the example prediction, if the model author has not set a cover image and the example prediction has no output file.
- A generic fallback image.

The `default_example` object is a [prediction](#predictions.get) created with this model.

The `latest_version` object is the model's most recently pushed [version](#models.versions.get).

## Path parameters

- `model_owner` string, required
- `model_name` string, required

## Response `200`

Success

- SchemasModelResponse
  - `cover_image_url` string, uri, nullable — A URL for the model's cover image
  - `default_example` object, nullable — The model's default example prediction
  - `description` string, nullable — A description of the model
  - `github_url` string, uri, nullable — A URL for the model's source code on GitHub
  - `is_official` boolean — Boolean indicating whether the model is officially maintained by Replicate. Official models are always on, have stable API interfaces, and predictable pricing.
  - `latest_version` object, nullable — The model's latest version
  - `license_url` string, uri, nullable — A URL for the model's license
  - `name` string — The name of the model
  - `owner` string — The name of the user or organization that owns the model
  - `paper_url` string, uri, nullable — A URL for the model's paper
  - `run_count` integer — The number of times the model has been run
  - `url` string, uri — The URL of the model on Replicate
  - `visibility` 'public' | 'private' — Whether the model is public or private

---

[API](https://skmtc.net/replicate/apis/replicate-http-api.md) · [All operations](https://skmtc.net/replicate/apis/replicate-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicate/replicate-http-api/versions/7a537f433b0b/schema)