image_playground_generate

macOS

Scopo

Genera sul Mac un’immagine a partire da un testo con Image Playground di Apple, usando il modello di Apple sul dispositivo (Apple Intelligence / Core ML; senza chiave API). Salva un PNG e lo mostra nel Finder perché l’utente lo veda e lo trascini dove vuole. Gli stili sono quelli inclusi da Apple (animation, illustration, sketch): adatti a immagini stilizzate veloci, NON fotorealistiche. Richiede macOS 15.4+ con Apple Intelligence attivato. Su macOS 15.x/26 la generazione è del tutto automatica; su macOS 27+ si apre un piccolo pannello di Image Playground e l’utente fa clic una volta sull’immagine per salvarla (l’API pubblica di Apple in quella versione). DOVE SALVARE: se l’utente indica un posto (ad es. «la mia Scrivania», «la cartella del progetto»), passalo come output_path; altrimenti omettilo e l’immagine finisce in ~/Pictures/Image Playground/ con un nome preso dal testo, poi si apre nel Finder.

Input obbligatori

• prompt

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

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

Esempio documentale

Esempio di documentazione per image_playground_generate. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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