image_playground_generate

macOS

Finalidade

Gera no Mac uma imagem a partir de um texto com o Image Playground da Apple, usando o modelo da Apple no dispositivo (Apple Intelligence / Core ML; sem chave de API). Salva um PNG e o mostra no Finder para que o usuário o veja e o arraste para onde quiser. Os estilos são os que a Apple inclui (animation, illustration, sketch): bons para arte estilizada rápida, NÃO fotorrealista. Requer macOS 15.4+ com Apple Intelligence ativado. No macOS 15.x/26 a geração é totalmente automática; no macOS 27+ abre-se um pequeno painel do Image Playground e o usuário clica uma vez na imagem para salvá-la (a API pública da Apple nessa versão). ONDE SALVAR: se o usuário indicar um lugar (por exemplo, "minha Mesa", "a pasta do projeto"), passe-o como output_path; caso contrário, omita-o e a imagem vai para ~/Pictures/Image Playground/ com um nome tirado do texto, e depois abre no Finder.

Entradas obrigatórias

• prompt

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para image_playground_generate. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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