お手持ちのメディアを渡す

メディアを受け付けるすべてのフィールド（image_asset_id、reference_video_asset_ids、asset_id、その他すべての *_asset_id や *_asset_ids）には、ライブラリのアセット ID か、ファイルの公開 HTTPS URL のどちらでも指定できます。1 回の呼び出しの中で自由に混在させられます。別途アップロードの手順はありません。

curl -s https://mcp.morphic.com/v1/direct/tools/edit_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Put the bike on a beach at sunset", "image_asset_ids": ["https://cdn.example.com/products/bike.jpg"], "project_id": "01928f4e-…"}}'

ツールの実行前に、各 URL が取得され、アップロード済みのアセットとして project_id に無料で追加されます。その後、ツールは他のアセットと同じようにそれを処理します。URL の指定には assets:write スコープが必要で、異なる URL ごとに 無料の呼び出しのバケット の 1 回の呼び出しとしてカウントされます。

• URL は公開ホスト上の HTTPS で、Web ページではなくファイルそのものを返す必要があります。
• お客様のストレージにあるファイルには、署名付き URL（S3 の署名付き GET、GCS の署名付き URL）を渡してください。呼び出しが応答するまで有効な状態を保ってください。
• 画像、動画、音声、ドキュメント（.pdf、.txt、.md、.srt）を受け付けます。バイト列を調べて判定するため、拡張子は信頼されません。
• メディアファイルのサイズは最大 100 MB（プランのアップロード上限のほうが小さい場合はその上限）で、25 秒以内に届く必要があります。
• 1 回の呼び出しで 2 回指定された URL は 1 回だけ取得されます。後の呼び出しでは再度取得されます。再取得せずにファイルを再利用するには、list_assets に表示されるそのファイルのアセット ID を渡してください。
• 呼び出しの入力は、URL を取得する前にツールのスキーマに照らして検証されます。形式が正しくない呼び出しは 400 invalid_request を返し、何も取得しません。
• 取得できない URL や受け付けられない URL は、フィールドを示して 422 tool_refused を返します（例: input.image_asset_ids[0]: The URL must use https.）。何も開始されず、請求も発生しません。すでに追加されたファイルは、ツール自体が後から呼び出しを拒否した場合と同様に、プロジェクトに残ります。
• analyze_video と analyze_audio が project_id を受け取るのはこの用途のためだけです。メディアフィールドに URL を指定するときに送信してください。
• plan_media のステップでも URL を指定でき、それぞれがそのステップの project_id に追加されるため、見積もりによってそれらのファイルがライブラリに追加されます。実行するステップには、URL ではなくその後 list_assets に表示されるアセット ID を渡すと、各ファイルの取得が 1 回で済みます。

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