image_playground_generate

macOS

Назначение

Создаёт изображение на Mac по текстовому описанию с помощью Image Playground от Apple, используя модель Apple на устройстве (Apple Intelligence / Core ML; без ключа API). Сохраняет PNG и показывает его в Finder, чтобы пользователь увидел файл и перетащил куда угодно. Стили — встроенные стили Apple (animation, illustration, sketch): подходят для быстрой стилизованной графики, НЕ для фотореализма. Требуется macOS 15.4+ с включённым Apple Intelligence. В macOS 15.x/26 генерация полностью автоматическая; в macOS 27+ открывается небольшая панель Image Playground, и пользователь один раз нажимает на изображение, чтобы сохранить его (публичный API Apple в этой версии). КУДА СОХРАНИТЬ: если пользователь называет место (например, «мой рабочий стол», «папка проекта»), передайте его как 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"
}