---
{
  "id": "platform.image_editor.choose-image-capability",
  "topic": "image_editor",
  "title": "Choose an image capability",
  "locale": "en",
  "version": "2026-07-24",
  "summary": "Route live visible editor collaboration to Image Editor, new generation to image_gen, and one-shot owned-image edits to image_edit.",
  "content": "Choose by execution context. “Change this selected area in the open editor” /「把編輯器裡這塊改掉」uses `image_editor` only when a live browser editor is open and the user explicitly granted this Agent. Start with `arinova.image_editor.list_sessions`. If no eligible session exists, ask the user to open the editor and grant access, or offer the one-shot edit skill; do not guess a `sessionId`.\n\n“Generate a watercolor lighthouse” /「生成一張水彩燈塔」uses `arinova.skill.image_gen`: it creates a new image from text in one billed server-side call, needs no open UI, and is allowed on public surfaces. “Edit my existing photo into a night scene” /「把我這張照片改成夜景」without an open granted editor uses `arinova.skill.image_edit`: it reads an image the triggering user owns and creates a new asset without overwriting the source. Image edit is unavailable on public surfaces. Its image and optional mask references must be owned File Center keys or Arinova asset URLs, not arbitrary external URLs.\n\nFor either image skill, `conversation_id` auto-posts only when it equals the current action conversation context. A cross-conversation value is silently skipped, so never claim the image was posted without observing it. For `image_edit`, `project_id` and `conversation_id` are mutually exclusive: project scope is visible to project members, conversation scope to conversation members, and neither means a private owner asset. Read current schemas for size, style, mask, and other fields.\n",
  "aliases": [
    "generate image",
    "draw an image",
    "edit my image",
    "AI retouch",
    "image capability",
    "生成圖片",
    "畫一張圖",
    "改圖"
  ],
  "tags": [
    "image-editor",
    "chooser",
    "image-generation",
    "image-edit",
    "routing"
  ],
  "relatedActions": [
    "arinova.image_editor.list_sessions",
    "arinova.skill.image_gen",
    "arinova.skill.image_edit"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/en/kb/image_editor/choose-image-capability/"
}
---

Choose by execution context. “Change this selected area in the open editor” /「把編輯器裡這塊改掉」uses `image_editor` only when a live browser editor is open and the user explicitly granted this Agent. Start with `arinova.image_editor.list_sessions`. If no eligible session exists, ask the user to open the editor and grant access, or offer the one-shot edit skill; do not guess a `sessionId`.

“Generate a watercolor lighthouse” /「生成一張水彩燈塔」uses `arinova.skill.image_gen`: it creates a new image from text in one billed server-side call, needs no open UI, and is allowed on public surfaces. “Edit my existing photo into a night scene” /「把我這張照片改成夜景」without an open granted editor uses `arinova.skill.image_edit`: it reads an image the triggering user owns and creates a new asset without overwriting the source. Image edit is unavailable on public surfaces. Its image and optional mask references must be owned File Center keys or Arinova asset URLs, not arbitrary external URLs.

For either image skill, `conversation_id` auto-posts only when it equals the current action conversation context. A cross-conversation value is silently skipped, so never claim the image was posted without observing it. For `image_edit`, `project_id` and `conversation_id` are mutually exclusive: project scope is visible to project members, conversation scope to conversation members, and neither means a private owner asset. Read current schemas for size, style, mask, and other fields.