# Replicate API

**Provider:** Replicate
**Category:** ai
**Base URL:** `https://api.replicate.com/v1`
**Auth:** bearer — `Authorization: Bearer r8_...`
**Rate Limit:** No hard limit (scales with your account tier)
**Free Tier:** No
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://replicate.com/docs

## Description

Replicate makes it easy to run machine learning models with a single API call. Access thousands of open-source models for image generation (SDXL, Flux, ControlNet), video generation (Stable Video Diffusion), audio (Whisper, MusicGen), language (Llama 3, Mistral), and specialized tasks like upscaling, background removal, and object detection. Deploy private models and fine-tunes too.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.replicate.com/v1/predictions` | Run a model and create a prediction |
| GET | `https://api.replicate.com/v1/predictions/{prediction_id}` | Get prediction status and output |
| GET | `https://api.replicate.com/v1/models` | List available public models |
| GET | `https://api.replicate.com/v1/models/{owner}/{model_name}` | Get model details and latest version |
| POST | `https://api.replicate.com/v1/models/{owner}/{model_name}/versions/{id}/predictions` | Run a specific model version |

## Authentication

Create an API token at replicate.com/account/api-tokens. Pass it as a Bearer token in the Authorization header.

```
Authorization: Bearer r8_...
```

## Sample Request

```bash
curl "https://api.replicate.com/v1/predictions" \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"version":"db21e45d3f7023abc2a46ee38a23973f6dce16bb082a930b0c49861f96d1e5bf","input":{"prompt":"A photo of a cat wearing a beret in Paris"}}'
```

## Sample Response

```json
{
  "id": "xyz789abc",
  "status": "starting",
  "model": "stability-ai/sdxl",
  "urls": {
    "get": "https://api.replicate.com/v1/predictions/xyz789abc",
    "cancel": "https://api.replicate.com/v1/predictions/xyz789abc/cancel"
  }
}
```

## Pricing Details

Billed by the second per hardware tier: CPU $0.000225/sec, Nvidia T4 $0.0012/sec, A40 $0.0023/sec, A100 $0.0115/sec. Image gen ~$0.003–0.012/image.

---

*Source: [API Map](https://apimap.dev/apis/replicate/) — CC BY 4.0*