name: Replicate自动化 description: “自动化Replicate AI模型操作——通过Composio MCP集成运行预测、上传文件、检查模型模式、列出版本和管理预测历史。” requires: mcp: - rube

Replicate自动化

自动化您的Replicate AI模型工作流——在任何公共模型上运行预测（图像生成、LLMs、音频、视频）、上传输入文件、检查模型模式和文档、列出模型版本以及跟踪预测历史。

工具包文档: composio.dev/toolkits/replicate

设置

将Composio MCP服务器添加到您的客户端: https://rube.app/mcp
在提示时连接您的Replicate账户（API令牌认证）
开始使用以下工作流

核心工作流

1. 获取模型详情和模式

使用 REPLICATE_MODELS_GET 在运行预测前检查模型的输入/输出模式。

工具: REPLICATE_MODELS_GET
输入:
  - model_owner: 字符串 (必需) -- 例如, "meta", "black-forest-labs", "stability-ai"
  - model_name: 字符串 (必需) -- 例如, "meta-llama-3-8b-instruct", "flux-1.1-pro"

重要: 每个模型都有唯一的输入键和类型。在构建预测输入前，始终检查此响应的 openapi_schema。

2. 运行预测

使用 REPLICATE_MODELS_PREDICTIONS_CREATE 在任何模型上运行推理，可选择同步等待和Webhooks。

工具: REPLICATE_MODELS_PREDICTIONS_CREATE
输入:
  - model_owner: 字符串 (必需) -- 例如, "meta", "black-forest-labs"
  - model_name: 字符串 (必需) -- 例如, "flux-1.1-pro", "sdxl"
  - input: 对象 (必需) -- 模型特定输入，例如, { "prompt": "山脉上的日落" }
  - wait_for: 整数 (1-60 秒, 可选) -- 同步等待完成
  - cancel_after: 字符串 (可选) -- 最大执行时间，例如, "300s", "5m"
  - webhook: 字符串 (可选) -- 异步完成通知的HTTPS URL
  - webhook_events_filter: 数组 (可选) -- ["start", "output", "logs", "completed"]

同步 vs 异步: 对快速模型使用 wait_for (1-60s)。对于长时间运行的任务，省略它并使用Webhooks或通过 REPLICATE_PREDICTIONS_LIST 轮询。

3. 上传文件用于模型输入

使用 REPLICATE_CREATE_FILE 上传模型所需的图像、文档或其他二进制输入。

工具: REPLICATE_CREATE_FILE
输入:
  - content: 字符串 (必需) -- base64编码的文件内容
  - filename: 字符串 (必需) -- 例如, "input.png", "audio.wav" (最大255字节UTF-8)
  - content_type: 字符串 (默认 "application/octet-stream") -- MIME类型
  - metadata: 对象 (可选) -- 自定义JSON元数据

4. 读取模型文档

使用 REPLICATE_MODELS_README_GET 以Markdown格式访问模型的README以获取详细使用说明。

工具: REPLICATE_MODELS_README_GET
输入:
  - model_owner: 字符串 (必需)
  - model_name: 字符串 (必需)

5. 列出模型版本

使用 REPLICATE_MODELS_VERSIONS_LIST 查看模型的所有可用版本，按最新排序。

工具: REPLICATE_MODELS_VERSIONS_LIST
输入:
  - model_owner: 字符串 (必需)
  - model_name: 字符串 (必需)

6. 跟踪预测历史和管理文件

使用 REPLICATE_PREDICTIONS_LIST 检索预测历史，以及 REPLICATE_FILES_GET/REPLICATE_FILES_LIST 管理上传的文件。

工具: REPLICATE_PREDICTIONS_LIST
  - 列出经过身份验证用户的所有预测（分页）

工具: REPLICATE_FILES_LIST
  - 列出上传的文件，按最新排序

工具: REPLICATE_FILES_GET
  - 通过ID获取特定文件的详细信息

已知陷阱

陷阱	详情
模型特定输入键	每个模型都有唯一的输入键和类型。使用错误的键会导致验证错误。始终首先调用 `REPLICATE_MODELS_GET` 检查 `openapi_schema`。
文件上传编码	`REPLICATE_CREATE_FILE` 需要base64编码的内容。将二进制文件视为文本（UTF-8）会导致解码错误。
公共 vs 部署路径	公共模型必须通过 `REPLICATE_MODELS_PREDICTIONS_CREATE` 运行。使用面向部署的路径会导致HTTP 404失败。
同步等待限制	`wait_for` 仅支持1-60秒。长时间运行的任务需要通过Webhooks或轮询 `REPLICATE_PREDICTIONS_LIST` 进行异步处理。
图像模型约束	图像模型如flux-1.1-pro有特定约束（例如，最大宽度/高度1440px，有效宽高比）。首先检查模型模式。
陈旧文件引用	频繁使用会创建许多上传。定期检查 `REPLICATE_FILES_LIST` 以避免使用陈旧的 `file_id` 引用。

快速参考

工具标识	描述
`REPLICATE_MODELS_GET`	获取模型详情、模式和元数据
`REPLICATE_MODELS_PREDICTIONS_CREATE`	在模型上运行预测
`REPLICATE_CREATE_FILE`	为模型输入上传文件
`REPLICATE_MODELS_README_GET`	获取模型README文档
`REPLICATE_MODELS_VERSIONS_LIST`	列出模型的所有版本
`REPLICATE_PREDICTIONS_LIST`	列出预测历史（分页）
`REPLICATE_FILES_LIST`	列出上传的文件
`REPLICATE_FILES_GET`	通过ID获取文件详情

由 Composio 提供支持