ツールカタログ
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 |
list_elements | assets:read | 組織の Element(学習済みのキャラクターとスタイル)と、生成が参照として受け取る 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、video_to_alpha。
video_to_alpha は、動画から人物や指定したオブジェクトを切り抜いて、透明な背景にします。Enterprise プランでのみ実行できます。
音声(有料、生成を返す)
スコープ 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、およびオーディオエフェクトの audio_equalize、audio_compress、audio_limit、audio_gate、audio_deess、audio_denoise、audio_reverb、audio_gain、audio_fade。エフェクトはそれぞれ、効果を適用した新しい音声ファイルを返します。
dub_media は、media_asset_id(音声または動画ファイル 1 つ)、target_language(hi や pt-BR のような BCP-47 タグ 1 つ。複数の言語は複数の呼び出しになります)、省略可能な source_language(省略すると自動で検出)、省略可能な keyterms(そのまま残す名前や用語。それぞれ 5 語まで)、省略可能な model_id を受け取ります。Morphic Dub(mdl_h2z5a7af7y50)では口の動きを合わせた動画そのものを返し、開始時の請求額は実行時の消費額に精算される見積もりです。Morphic Dub はさらに、voices を伴う voice_mode: "assigned"(各話者を画像か音声のアセット、または短い説明で指定し、mdl_h2z5a7af7y50 向けの list_voices から取得した voice_id を添えます。カタログの声のみ)と、自分のタイミング付き SRT を source_transcript_asset_id(話されている言語)または translation_asset_id(対象言語)として、URL またはライブラリのドキュメントで受け取ります。どちらの声のモードでも使えます。MCP では、ElevenLabs Dubbing(model_name: "ElevenLabs Dubbing")も元の声のまま 2 つの SRT を受け取ります。その場合は source_language が必須で、翻訳は文字起こしと一緒にのみ渡せます。吹き替え を参照してください。
分析(有料、呼び出しの中で応答)
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.