---
{
  "id": "platform.image_editor.choose-image-capability",
  "topic": "image_editor",
  "title": "選擇正確的圖像能力",
  "locale": "zh-TW",
  "version": "2026-07-24",
  "summary": "開著編輯器的可見協作用 Image Editor，文字生新圖用 image_gen，無 live session 的自有圖單發編輯用 image_edit。",
  "content": "依執行 context 分流。「把編輯器裡這塊改掉」/ “Change this selected area in the open editor” 只有在 browser editor 正開著、且使用者明確 grant 本 Agent 時才走 `image_editor`；先呼叫 `arinova.image_editor.list_sessions`。若沒有 eligible session，請使用者開啟編輯器並授權，或改提議單發 edit skill；不可猜 `sessionId`。\n\n「生成一張水彩燈塔」/ “Generate a watercolor lighthouse” 走 `arinova.skill.image_gen`：用文字在 server-side 單次計費呼叫建立新圖，不需要開 UI，而且可在 public surface 執行。「把我這張照片改成夜景」/ “Edit my existing photo into a night scene” 若沒有已 grant 的 open editor，走 `arinova.skill.image_edit`：讀取觸發使用者擁有的圖片，產生新 asset，永不覆寫來源；image edit 不可在 public surface 執行。image 與 optional mask 只能引用自有 File Center key 或 Arinova asset URL，不接受任意外部 URL。\n\n兩個 image skills 的 `conversation_id` 都只有在等於目前 action conversation context 時才 auto-post；跨對話會安靜跳過，所以未觀察到貼圖前不得宣稱已貼出。`image_edit` 的 `project_id` 與 `conversation_id` 互斥：project scope 對 project members 可見，conversation scope 對 conversation members 可見，兩者皆無則為 owner private asset。size、style、mask 等欄位一律讀現行 schema。\n",
  "aliases": [
    "生成圖片",
    "畫一張圖",
    "AI 修圖",
    "改圖",
    "編輯我的圖片",
    "generate image",
    "edit my image"
  ],
  "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/zh-tw/kb/image_editor/choose-image-capability/"
}
---

依執行 context 分流。「把編輯器裡這塊改掉」/ “Change this selected area in the open editor” 只有在 browser editor 正開著、且使用者明確 grant 本 Agent 時才走 `image_editor`；先呼叫 `arinova.image_editor.list_sessions`。若沒有 eligible session，請使用者開啟編輯器並授權，或改提議單發 edit skill；不可猜 `sessionId`。

「生成一張水彩燈塔」/ “Generate a watercolor lighthouse” 走 `arinova.skill.image_gen`：用文字在 server-side 單次計費呼叫建立新圖，不需要開 UI，而且可在 public surface 執行。「把我這張照片改成夜景」/ “Edit my existing photo into a night scene” 若沒有已 grant 的 open editor，走 `arinova.skill.image_edit`：讀取觸發使用者擁有的圖片，產生新 asset，永不覆寫來源；image edit 不可在 public surface 執行。image 與 optional mask 只能引用自有 File Center key 或 Arinova asset URL，不接受任意外部 URL。

兩個 image skills 的 `conversation_id` 都只有在等於目前 action conversation context 時才 auto-post；跨對話會安靜跳過，所以未觀察到貼圖前不得宣稱已貼出。`image_edit` 的 `project_id` 與 `conversation_id` 互斥：project scope 對 project members 可見，conversation scope 對 conversation members 可見，兩者皆無則為 owner private asset。size、style、mask 等欄位一律讀現行 schema。