> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Replicate

> Browse public models and run predictions on Replicate-hosted machine learning models

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key comes from `REPLICATE_API_TOKEN`.
* **Docs**: [https://replicate.com/docs/reference/http](https://replicate.com/docs/reference/http)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable              | Required | Description                                                                              |
| --------------------- | -------- | ---------------------------------------------------------------------------------------- |
| `REPLICATE_API_TOKEN` | Yes      | Replicate API token (starts with r8\_) [Docs](https://replicate.com/account/api-tokens). |

## Setup

1. **Create a Replicate account**: Go to [https://replicate.com](https://replicate.com) and sign up (GitHub sign-in supported). New accounts get a small amount of free usage before billing is required.
2. **Create an API token**: Open [https://replicate.com/account/api-tokens](https://replicate.com/account/api-tokens), give the token a descriptive name (e.g. 'Veryfront Integration'), and create it.
3. **Store the token**: Copy the token and add it to your .env file as REPLICATE\_API\_TOKEN=r8\_...
4. **Verify access**: Run the List Models tool to confirm the token works. A 401 means the token is wrong or revoked.

* Predictions are billed per second of compute - costs vary widely by model and hardware
* Create Prediction sends Prefer: wait=60 to return synchronously when possible; long-running models still return status 'starting' or 'processing' - poll with Get Prediction
* Use the version ID from Get Model's latest\_version.id field when creating predictions

Provider API reference: [https://replicate.com/docs/reference/http](https://replicate.com/docs/reference/http)

## Tools

| Tool              | Access | Description                                                             |
| ----------------- | ------ | ----------------------------------------------------------------------- |
| List Models       | Read   | List public models available on Replicate                               |
| Get Model         | Read   | Get details about a model, including its latest version ID              |
| Create Prediction | Write  | Run a model by creating a prediction from a version ID and input object |
| Get Prediction    | Read   | Get the status and output of a prediction                               |
| Cancel Prediction | Write  | Cancel a running prediction                                             |

## Example prompts

* Find a Replicate model for a task I describe and show me its latest version ID and inputs.
* Run a Replicate model with inputs I provide and report the output when it finishes.
