Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Replicate Predictions API

The Predictions API from Replicate — 5 operation(s) for predictions.

Replicate Predictions API is one of 16 APIs that Replicate publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Predictions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 6 operations across 5 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0-a1.

Requests are made against a single base URL, https://api.replicate.com/v1.

6 operations 5 paths 2 schemas 2 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0-a1
Server
https://api.replicate.com/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Replicate Predictions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (All API requests must include a valid API token in the `Authorization` request header. The token must be prefixed by "Bearer", followed by a space and the token value. Example: `Authorization: Bearer r8_Hw***********************************` Find your tokens at https://replicate.com/account/api-tokens ) (bearerAuth). By default, every request must be authenticated.

Paths & Operations 6

Across 5 paths, the API surfaces 6 operations — 2 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Predictions 6
POST
/deployments/{deployment_owner}/{deployment_name}/predictions
Create a Prediction Using a Deployment
deployments.predictions.create 3 params body → 201202
POST
/models/{model_owner}/{model_name}/predictions
Create a Prediction Using an Official Model
models.predictions.create 3 params body → 201202
GET
/predictions
List Predictions
predictions.list → 200
POST
/predictions
Create a Prediction
predictions.create 1 param body → 201202
GET
/predictions/{prediction_id}
Get a Prediction
predictions.get 1 param → 200
POST
/predictions/{prediction_id}/cancel
Cancel a Prediction
predictions.cancel 1 param → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are schemas_version_prediction_request (5 properties), schemas_prediction_request (4 properties). Each schema is shown below with its type and property counts.

schemas_version_prediction_request
object
5 properties 2 required
schemas_prediction_request
object
4 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

replicate-predictions-api-openapi.yml Raw ↑

Other APIs Replicate publishes across the network.

Replicate Accounts API
Replicate Cancel API
Replicate Collections API
Replicate Deployments API
Replicate Hardware API
Replicate Model API
Replicate Models API
Replicate Name API
Replicate Owner API
Replicate Secrets API
Replicate Slug API
Replicate Training API