ツールカタログ
Direct API のツールとその JSON Schema の取得方法と、v1 のすべてのツールおよび必要なスコープを紹介します。
Direct API は Morphic MCP サーバー と同じツール定義から生成されます。そのため、API が提供するカタログは常に最新のもので、お客様のプランで利用できるすべてのモデルが含まれます。
ツールを確認する
| リクエスト | 返すもの |
|---|---|
GET /v1/direct/tools | このキーで呼び出せるすべてのツールと、その完全な JSON Schema を { "tools": [ … ] } として返します |
GET /v1/direct/tools/{tool_name} | 上記の一覧の 1 項目を { "tool": { … } } として返します |
GET /v1/direct/openapi.json | 同じ定義から作られた、API 全体の OpenAPI 3.1 ドキュメント。型付きクライアントの生成に使えます |
curl -s https://mcp.morphic.com/v1/direct/tools \
-H "Authorization: Bearer $MORPHIC_API_KEY"{
"tools": [
{
"name": "generate_image",
"title": "Generate image",
"description": "Text to image. TAKES IN: a prompt … PRODUCES: one new image per variation …",
"required_scopes": ["generations:write"],
"charges_credits": true,
"returns_generation": true,
"input_schema": { "type": "object", "properties": { "prompt": { "type": "string", "maxLength": 4000 }, "…": {} }, "required": ["prompt"], "additionalProperties": false },
"output_schema": { "type": "object", "properties": { "generation_id": { "type": "string" }, "…": {} } },
"annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }
}
]
}| フィールド | 意味 |
|---|---|
charges_credits | ツールがクレジットを消費する可能性があります。クレジットと使用量 を参照 |
returns_generation | ツールは、生成 として追跡する非同期の作業を開始します |
input_schema | 呼び出しボディの input の JSON Schema。厳格です。未知のキーは無視されず、拒否されます。 |
output_schema | レスポンスの result の JSON Schema。拡張可能です。新しいフィールドが追加されることがあります。 |
v1 のツール
GET /v1/direct/tools が、常に最新の正式な一覧です。v1 の時点では次のとおりです。
アカウントとカタログ（無料）
| ツール | スコープ | 内容 |
|---|---|---|
list_voices | なし | 音声合成モデルが提供するボイスと、それぞれの voice_id |
list_projects | projects:read | お客様のプロジェクト |
list_workflows、get_workflow | projects:read | 保存されたワークフロー |
list_characters | assets:read | 学習済みのキャラクターと、編集で使う ID |
plan_media | assets:read | 複数ステップのプランを検証して見積もります。消費する前に見積もる を参照 |
ライブラリ（無料）
| ツール | スコープ | 内容 |
|---|---|---|
list_assets | assets:read | アップロード、生成結果、ドキュメントをリンク付きで一覧表示。URL で指定したファイルもここに表示されます |
list_generations | assets:read | 最近の生成とそのステータス、アセット |
画像（有料、生成を返す）
スコープ generations:write: generate_image、edit_image、upscale_image、enhance_image、outpaint_image、inpaint_image、image_compose、image_crop、image_resize、image_rotate、image_flip、image_extend_to_aspect_ratio、image_make_color_transparent。
動画（有料、生成を返す）
スコープ generations:write: generate_video、edit_video、upscale_video、enhance_video、finalize_video_draft、lip_sync、video_compose、video_resize、video_change_frame_rate、video_rotate、video_flip、video_change_speed、video_reverse、video_remove_audio、video_frame_to_image、burn_subtitles。
音声（有料、生成を返す）
スコープ generations:write: generate_speech、generate_music、generate_sound_effect、generate_dialogue、change_voice、transcribe_media、separate_stems、dub_media、audio_compose、audio_trim、extract_audio。
分析（有料、呼び出しの中で応答）
analyze_video と analyze_audio には、スコープ generations:write と assets:read が必要です。生成は開始せず、分析が失敗した場合は請求額が返金されます。
Compose タイムライン
このグループのツールは、名前に filmlab_ の接頭辞が付いたままです。
| ツール | スコープ | 料金 |
|---|---|---|
filmlab_list_timelines、filmlab_read_timeline | projects:read | 無料 |
filmlab_create_timeline | assets:write | 無料 |
filmlab_get_documentation | なし | 無料 |
filmlab_edit | generations:write と assets:write | コマンドごと |
filmlab_export | generations:write | 生成を返します |
Direct API にないもの
| MCP ツール | 代わりに使うもの |
|---|---|
list_models | モデル |
get_credit_balance | GET /v1/direct/me |
get_generation_status、wait_for_generations、show_generation、show_asset | GET /v1/direct/generations/{id} と POST /v1/direct/generations/batch-get |
何かお困りのことやご質問がありましたら、お気軽にご連絡ください。喜んでお手伝いします。こちらまでご連絡ください support@morphic.com.