find-models について
find-modelsは、Replicate APIで現在利用できるモデルを探すスキルです。タスク別検索やコレクションで候補を絞り、利用前にモデルのスキーマを確認する方法を案内します。
主な機能
- 01APIによるタスク別モデル検索
- 02コレクションによる候補の絞り込み
- 03入出力スキーマの確認
- 04モデルのメタデータとタグの確認
- 05公式・コミュニティ識別子の区別
活用シーン
- 01特定タスクに使える現行モデルの検索
- 02比較前のモデル候補の選定
- 03モデル実行前の必須入力の確認
MCP 対応
ドキュメントにはMCPサーバーへの参照がありますが、MCP機能の説明はありません。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ replicate/ skills --skill find-modelsインストール後、Claude Code で/find-modelsを入力して読み込まれたか確認します。
詳細
常に API を検索して最新のモデルを確認してください
AI モデルの状況は毎週変化します。新しいモデルが次々とリリースされ、古いモデルは非推奨になったり、より優れたモデルに取って代わられたりします。過去の会話や学習データで見たモデル名に頼らないでください。「知っている」特定のモデルは、最適な選択肢ではなくなっていたり、新しい代替モデルより遅かったり、すでに存在しなくなっていたりする可能性があります。
必ず最初に Replicate API に問い合わせてください。検索とコレクションを使って現在利用できるものを見つけ、その後、スキーマを読み取って入力と出力を理解してから実行してください。
ドキュメント
- リファレンス:https://replicate.com/docs/llms.txt
- OpenAPI スキーマ:https://api.replicate.com/openapi.json
- MCP サーバー:https://mcp.replicate.com
- モデルごとのドキュメント:
https://replicate.com/{owner}/{model}/llms.txt - Markdown 形式のレスポンスでドキュメントページを取得する場合は、
Accept: text/markdownを設定してください。
検索
- 検索 API(
GET /v1/search?query=...)を使って、タスク別にモデルを検索してください。モデル、コレクション、ドキュメントが返されます。 - 検索では、各モデルの
tags、generated_description、run_countなどのメタデータが返されます。 - 検索 API は、モデルの検索結果とともに一致するコレクションも返します。
- API を使ってすべてのモデルを一覧表示するのは避けてください。大量の情報が返されます。対象を絞って検索してください。
コレクション
- コレクションは、Replicate のスタッフが管理する、厳選されたモデルのグループです。
officialコレクションには、常時起動していて、安定した API と予測可能な料金を備えたモデルが含まれています。- コレクションを使って候補を絞り込んでから、詳しく比較してください。
- コレクション一覧は
GET /v1/collectionsで取得します。スラッグを指定すると、GET /v1/collections/{slug}で個別のコレクションを取得できます。
モデルスキーマの確認
- すべてのモデルは、モデル API(
GET /v1/models/{owner}/{name})を通じて入出力スキーマを公開しています。 - スキーマのパス:
model.latest_version.openapi_schema.components.schemas.Input.properties - 各プロパティには、
type、description、default、minimum/maximum、enum、format(ファイル入力の場合はuriなど)が含まれることがあります。 - モデルを実行する前に、必ずスキーマを取得してください。スキーマは変更されます。
適切なモデルの選び方
- 公式モデルを優先してください。常時起動しているためコールドブートがなく、安定した API と予測可能な料金を備えています。
- 最新バージョンを優先してください。検索結果に v2.5 と v3.0 があれば、v3 を使ってください。
- 実行回数は誤解を招くことがあります。古いモデルは時間とともに実行回数が蓄積されますが、時代遅れになっている可能性があります。2023 年から 1,000 万回実行されているモデルより、2025 年から 10 万回実行されているモデルのほうが優れている可能性が高いです。
- 最近リリースされたモデルを優先してください。AI 分野の進歩は速いです。
- モデルのタグを確認して、タスク(
image-generation、video、audioなど)で絞り込んでください。
モデル識別子
- 公式モデルは
owner/name形式を使用します(例:owner/model-name)。最新バージョンに自動的にルーティングされます。 - コミュニティモデルでは
owner/name:version_idが必要です。特定のバージョンを指定する必要があります。コミュニティモデルはコールドブートすることがあり、起動に時間がかかる場合があります。 - コミュニティモデルを使用する必要がある場合は、起動に長い時間がかかることがある点に注意してください。常時稼働のデプロイメントを作成できますが、モデルの稼働時間に応じた料金が発生します。
コメント
Markdown 対応