# Run Replicate Model
**Action ID:** `replicate_run_model`
## Description
Run any model on Replicate.com with your API token. This node allows you to execute machine learning models for image generation, text processing, and other AI tasks.
## Provider
**Replicate**
## Connection
| Name | Description | Required | Category |
| -------------------- | ---------------------------------------------- | :------: | --------- |
| Replicate Connection | The Replicate connection to use for the model. | ✓ | replicate |
## Input Parameters
| Name | Type | Required | Default | Description |
| ------------- | ------ | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| model | string | ✓ | - | The Replicate model to run (format: 'username/model\_name:version' or 'username/model\_name'). Example: 'stability-ai/sdxl:39ed52f2a78e934b3ba6e2a89f5b1c712de7dfea535525255b1aa35c5565e08b' |
| input\_params | object | ✓ | - | The input parameters for the model. These vary depending on the model you're using. Check the model's documentation for details. |
| image\_input | string | - | - | Optional image input for models that require an image. This will be added to the input parameters with the key 'image'. |
| webhook\_url | string | - | - | Optional webhook URL to receive updates when the prediction is complete. |
View JSON Schema
```json
{
"description": "Run Replicate Model node input.",
"properties": {
"model": {
"title": "Model",
"type": "string",
"description": "The Replicate model to run (format: 'username/model_name:version' or 'username/model_name'). Example: 'stability-ai/sdxl:39ed52f2a78e934b3ba6e2a89f5b1c712de7dfea535525255b1aa35c5565e08b'"
},
"input_params": {
"title": "Input Parameters",
"type": "object",
"description": "The input parameters for the model. These vary depending on the model you're using. Check the model's documentation for details."
},
"image_input": {
"default": null,
"title": "Image Input",
"type": "string",
"description": "Optional image input for models that require an image. This will be added to the input parameters with the key 'image'."
},
"webhook_url": {
"default": null,
"title": "Webhook URL",
"type": "string",
"description": "Optional webhook URL to receive updates when the prediction is complete."
}
},
"required": [
"model",
"input_params"
],
"title": "ReplicateRunModelInput",
"type": "object"
}
```
## Output Parameters
| Name | Type | Description |
| ------ | ---- | ---------------------------------------------------------------------------------------------------------------------- |
| result | any | The output from the Replicate model. This can be text, URLs to generated images, or other data depending on the model. |
View JSON Schema
```json
{
"description": "Output from a Replicate model.",
"properties": {
"result": {
"title": "Result",
"description": "The output from the Replicate model. This can be text, URLs to generated images, or other data depending on the model."
}
},
"required": [
"result"
],
"title": "ReplicateModelOutput",
"type": "object"
}
```
## How It Works
This node sends a request to Replicate's API to run a specified machine learning model with your input parameters. Replicate queues the request and executes the model on their infrastructure. The node can optionally wait for the result synchronously or send a webhook URL to receive the result asynchronously. Once the model completes execution, the output (which may be images, text, or other data) is returned.
## Usage Examples
### Example 1: Image Generation with SDXL
**Input:**
```
model: "stability-ai/sdxl:39ed52f2a78e934b3ba6e2a89f5b1c712de7dfea535525255b1aa35c5565e08b"
input_params: {
"prompt": "A serene landscape with mountains at sunset",
"negative_prompt": "blurry, low quality",
"num_inference_steps": 30,
"guidance_scale": 7.5
}
```
**Output:**
```
result: [
"https://replicate.delivery/pbxt/output_123.png"
]
```
### Example 2: Text Generation Model
**Input:**
```
model: "mistralai/mistral-7b:5fe0a3d7cb86c4654d0629c949e306c7ec3fc47e2d917cdc880f4180f4e4991c"
input_params: {
"prompt": "Write a short story about a robot",
"max_tokens": 500,
"temperature": 0.7
}
```
**Output:**
```
result: "Once upon a time, a robot named ARIA discovered a love for painting. Despite being designed for factory work..."
```
### Example 3: Image with Webhook Notification
**Input:**
```
model: "stability-ai/sdxl"
input_params: {
"prompt": "A futuristic city skyline"
}
webhook_url: "https://my-app.com/webhook/replicate"
```
**Output:**
```
result: "https://replicate.delivery/pbxt/output_456.png"
```
(Webhook will also be called with results when ready)
## Common Use Cases
* **Image Generation**: Generate images using models like SDXL, Stable Diffusion, or other image generators
* **Text Processing**: Use language models for text generation, summarization, or translation
* **Audio Processing**: Run models for speech synthesis, voice cloning, or audio enhancement
* **Video Generation**: Create videos or video frames using generative models
* **Model Experimentation**: Test and compare different ML models without local infrastructure
* **Batch Processing**: Run models asynchronously using webhooks for long-running tasks
## Error Handling
| Error Type | Cause | Solution |
| ------------------------ | --------------------------------------------------- | ------------------------------------------------------------------- |
| Invalid Model | Model identifier doesn't exist or is malformed | Verify model format (username/model\_name:version) on Replicate.com |
| Missing Input Parameters | Required parameters for the model are not provided | Check the model's documentation for required input parameters |
| Invalid Image URL | Image URL is not publicly accessible | Ensure URLs are publicly accessible and use http\:// or https\:// |
| Timeout | Model execution takes longer than expected | Increase timeout or use webhook for asynchronous execution |
| Rate Limit | Too many concurrent API requests | Implement request queuing or use webhooks to distribute load |
| Insufficient Quota | Account doesn't have enough quota for the operation | Check your Replicate account quota and billing status |
## Notes
* **Model Format**: Always use the full model identifier. You can find available models and their versions on Replicate.com. For version-specific runs, include the version hash after a colon.
* **Input Parameters**: The `input_params` object structure depends entirely on the model. Refer to the specific model's documentation on Replicate to understand what parameters it accepts.
* **Image URLs**: URLs provided in `image_input` or within `input_params` should be publicly accessible. The model needs to download them.
* **Webhook Notifications**: If you provide a `webhook_url`, Replicate will send a POST request to that URL when the model finishes running. This is useful for asynchronous workflows.
* **Output Format**: Model outputs vary widely. Some return image URLs, others return text, and some return structured data. Check the specific model's documentation for output format.
* **Cost**: Replicate charges based on model execution time. Check pricing for specific models to understand costs.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.agenticflow.ai/reference/nodes/replicate_run_model.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.