ツールカタログ

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_projectsprojects:readお客様のプロジェクト
list_workflows、get_workflowprojects:read保存されたワークフロー
list_charactersassets:read学習済みのキャラクターと、編集で使う ID
list_elementsassets:read組織の Element(学習済みのキャラクターとスタイル)と、生成が参照として受け取る ID
plan_mediaassets:read複数ステップのプランを検証して見積もります。消費する前に見積もる を参照

ライブラリ(無料)

ツールスコープ内容
list_assetsassets:readアップロード、生成結果、ドキュメントをリンク付きで一覧表示。URL で指定したファイルもここに表示されます
list_generationsassets: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_timelineprojects:read無料
filmlab_create_timelineassets:write無料
filmlab_get_documentationなし無料
filmlab_editgenerations:write と assets:writeコマンドごと
filmlab_exportgenerations:write生成を返します

Direct API にないもの

MCP ツール代わりに使うもの
list_modelsモデル
get_credit_balanceGET /v1/direct/me
get_generation_status、wait_for_generations、show_generation、show_assetGET /v1/direct/generations/{id} と POST /v1/direct/generations/batch-get

何かお困りのことやご質問がありましたら、お気軽にご連絡ください。喜んでお手伝いします。こちらまでご連絡ください support@morphic.com.

このページの内容