Replicate ACTION
Create Prediction
Create a new prediction See the documentation
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Replicate account once, then configure and run Create Prediction from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "replicate-create-prediction",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
replicate: { authProvisionId: "apn_xxxxxxx" },
collectionSlug: "Collection Id",
modelId: "Model Id",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "replicate-create-prediction",
"configured_props": {
"replicate": { "authProvisionId": "apn_xxxxxxx" },
"collectionSlug": "Collection Id",
"modelId": "Model Id"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "replicate",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "replicate-create-prediction",
arguments: {
collectionSlug: "Collection Id",
modelId: "Model Id",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
collectionSlug Collection Id | string | The ID of the collection that you want to use. Required Dynamic |
modelId Model Id | string | The ID of the model version that you want to run. Required Dynamic |
version Model Version | string | The version of the model version that you want to use. Required Dynamic |
input Input | string | The model's input as a JSON object. The input depends on what model you are running. To see the available inputs, click the "Run with API" tab on the model you are running. For example, stability-ai/stable-diffusion takes prompt as an input. Required |
webhook Webhook | string | An HTTPS URL for receiving a webhook when the prediction has new output. Optional |
webhookEventsFilter Webhook Events Filter | string[] | By default, we will send requests to your webhook URL whenever there are new logs, new outputs, or the prediction has finished. See de documentartion here for more details. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- replicate-create-prediction
- Version
- 0.0.2
- App
- Replicate
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗