Replicate Automation
Replicate AIモデルのワークフローを自動化 — 公開モデル（画像生成、LLM、音声、動画）に対する予測実行、入力ファイルのアップロード、モデルスキーマとドキュメントの確認、モデルバージョンの一覧表示、予測履歴の追跡が可能です。
Toolkit ドキュメント: 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 を使用して、任意のモデルで推論を実行します。オプションで同期待機やWebhookを設定できます。
ツール: REPLICATE_MODELS_PREDICTIONS_CREATE
入力:
- model_owner: 文字列 (必須) — 例: "meta", "black-forest-labs"
- model_name: 文字列 (必須) — 例: "flux-1.1-pro", "sdxl"
- input: オブジェクト (必須) — モデル固有の入力、例: { "prompt": "A sunset over mountains" }
- wait_for: 整数 (1〜60秒、オプション) — 完了を同期待機
- cancel_after: 文字列 (オプション) — 最大実行時間、例: "300s", "5m"
- webhook: 文字列 (オプション) — 非同期完了通知用のHTTPS URL
- webhook_events_filter: 配列 (オプション) — ["start", "output", "logs", "completed"]
同期 vs 非同期: 高速なモデルには wait_for (1〜60秒) を使用します。長時間実行ジョブの場合は省略し、webhook または 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 を使用して、モデルのREADMEをMarkdown形式で取得し、詳細な使用手順を確認します。
ツール: 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秒のみサポートします。長時間実行ジョブでは、webhook または 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でファイル詳細を取得 |
Powered by Composio