image_playground_generate

macOS

Propósito

Genera en el Mac una imagen a partir de un texto con Image Playground de Apple, usando el modelo de Apple en el dispositivo (Apple Intelligence / Core ML; sin clave de API). Guarda un PNG y lo muestra en Finder para que el usuario lo vea y lo arrastre a donde quiera. Los estilos son los que trae Apple (animation, illustration, sketch): sirven para arte estilizado rápido, NO fotorrealista. Requiere macOS 15.4+ con Apple Intelligence activado. En macOS 15.x/26 la generación es totalmente automática; en macOS 27+ se abre un pequeño panel de Image Playground y el usuario hace clic una vez en la imagen para guardarla (la API pública de Apple en esa versión). DÓNDE GUARDAR: si el usuario nombra un lugar (p. ej. «mi Escritorio», «la carpeta del proyecto»), pásalo como output_path; si no, omítelo y la imagen queda en ~/Pictures/Image Playground/ con un nombre tomado del texto, y luego se abre en Finder.

Entradas obligatorias

• prompt

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de 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"
}

Ejemplo documental

Ejemplo de documentación para image_playground_generate. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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