Home / Topics / Models

We maintain over 100 official models that are always on, predictably priced, and have a stable API.

Official models are just like other models on Replicate, but with a few extra benefits:

  • Always on: Official models are always warm and ready to respond to requests, so you can run them without worrying about cold boots.
  • Stable API: The input and output API for every official model is stable. You can reliably use official models without having to worry about breaking changes or unexpected changes in the API.
  • Predictable pricing: Unlike other models which are priced by the hardware they use and the amount of time they run, official models are priced by predictable metrics, like the number of output image, seconds of video output, number of input and output tokens, etc.
  • Actively maintained: Replicate maintains the official models, and we work with the authors to make sure they’re high quality. We also make sure they’re always up to date with the latest version of the model.

API

The way you call official models is a little different from other models. If you’re using a Replicate library like the JavaScript or Python client, you don’t need to specify a version.

Here’s an example for running black-forest-labs/flux-1.1-pro in Node.js. Notice that the model identifer is just the owner and name (black-forest-labs/flux-1.1-pro), without a version:

import Replicate from "replicate";

const replicate = new Replicate();
const model = "black-forest-labs/flux-1.1-pro";
const input = { prompt: "A t-rex on a skateboard looking cool" };
const output = await replicate.run(model, { input });

console.log(output);

If you’re using the HTTP API to run an official model, you use the POST /models/<owner>/<name>/predictions endpoint and you don’t need to specify a version. For example:

curl https://api.replicate.com/v1/models/black-forest-labs/flux-1.1-pro/predictions \
	--request POST \
	--header "Authorization: Bearer $REPLICATE_API_TOKEN" \
	--header "Content-Type: application/json" \
	--header "Prefer: wait" \
	--data @- <<'EOM'
{
	"input": {
      "prompt": "A t-rex on a skateboard looking cool"
	}
}
EOM

Nothing has changed about how you run other models. The best way to find out how to run a model is the API documentation on a model.

Pricing

Instead of being charged by the amount of time a model runs, you’re charged by output (or in some cases, input). For example, black-forest-labs/flux-1.1-pro is charged for each image it generates, but for other models this might be things like the number of tokens or the duration of a video.

You can find out about each model’s pricing on the pricing section of the model.

Models

Replicate maintains over 100 official models, including:

For the full list, take a look at the official models collection.

Adding new official models

The collection of official models is always growing. If you know of a model that you think should be official, please let us know.