image_playground_generate

macOS

Objectif

Génère sur le Mac une image à partir d’un texte avec Image Playground d’Apple, grâce au modèle d’Apple sur l’appareil (Apple Intelligence / Core ML ; sans clé d’API). Enregistre un PNG et l’affiche dans le Finder pour que l’utilisateur le voie et le fasse glisser où il veut. Les styles sont ceux fournis par Apple (animation, illustration, sketch) : bien pour de l’art stylisé rapide, PAS photoréaliste. Nécessite macOS 15.4+ avec Apple Intelligence activé. Sous macOS 15.x/26 la génération est entièrement automatique ; sous macOS 27+ un petit panneau Image Playground s’ouvre et l’utilisateur clique une fois sur l’image pour l’enregistrer (l’API publique d’Apple dans cette version). OÙ ENREGISTRER : si l’utilisateur nomme un endroit (p. ex. « mon Bureau », « le dossier du projet »), passez-le comme output_path ; sinon, omettez-le et l’image est placée dans ~/Pictures/Image Playground/ avec un nom tiré du texte, puis s’ouvre dans le Finder.

Entrées requises

• prompt

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "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"
}

Exemple documentaire

Exemple de documentation pour image_playground_generate. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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