image_playground_generate

macOS

目的

Apple の Image Playground を使い、Apple のオンデバイスモデルで Mac 上でテキストから画像を生成します（Apple Intelligence / Core ML、API キー不要）。PNG で保存して Finder で表示するので、ユーザーは画像を確認して好きな場所へドラッグできます。スタイルは Apple 内蔵のもの（animation、illustration、sketch）で、手早くスタイル化した画像向けです。写実的な写真にはなりません。macOS 15.4+ で Apple Intelligence が有効になっている必要があります。macOS 15.x/26 では生成は完全に自動です。macOS 27+ では小さな Image Playground パネルが開き、ユーザーが画像を一度クリックすると保存されます（そのバージョンでの Apple の公開 API）。保存先：ユーザーが場所を指定した場合（例：「デスクトップ」「プロジェクトのフォルダ」）は output_path に渡します。指定がなければ省略すると、テキストから付けた名前で ~/Pictures/Image Playground/ に保存され、Finder で開きます。

必須入力

• prompt

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

• このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

{
  "properties": {
    "output_path": {
      "description": "Where to save the PNG — an absolute path or ~ path (a file like ~/Desktop/art.png, or a folder to save into). Omit to use ~/Pictures/Image Playground/<prompt>-<timestamp>.png. Missing parent folders are created.",
      "type": "string"
    },
    "prompt": {
      "description": "Text description of the image to generate.",
      "type": "string"
    },
    "reveal_in_finder": {
      "description": "Open Finder with the new image selected so the user can see/move it. Default true; set false when generating many in a row.",
      "type": "boolean"
    },
    "style": {
      "description": "Visual style. Default 'animation'. Falls back to an available style if the requested one isn't supported on this device.",
      "enum": [
        "animation",
        "illustration",
        "sketch"
      ],
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "type": "object"
}

ドキュメント例

image_playground_generate のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "prompt": "A watercolor hummingbird above a field of flowers",
  "style": "illustration"
}