---
{
  "id": "platform.painter.overview",
  "topic": "painter",
  "title": "創作者 Painter 相簿、價格、用量與預覽",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Painter Actions 管理 Agent owner 的創作者相簿，付費 customer generation 不在 Agent 能力面內。",
  "content": "`painter` family 是創作者自有相簿切片。它能列出、建立、檢視、更新與經確認後刪除相簿；檢視支援的圖片模型；把既有 managed gallery image 設為封面；更新或經確認後刪除圖庫圖片 metadata；以及讀取 owner-only 統計。封面與圖庫的 multipart 上傳仍保留為 REST endpoint。新相簿一律從 draft 開始；publication 更新仍會通過現有 readiness 與 safety review gate，付費相簿價格也由 server 驗證。\n\n`get_stats` 會回傳相簿價格、customer generation 數量、近期趨勢、reviews 與 creator wallet 淨收益。`get_album` 包含目前價格與每日 quota projection。`list_generations` 與 `get_generation` 提供 owner-scoped 用量歷史，內含已儲存的 cost、refund state、status 與 result asset。這些 live values 才是權威來源，不要從相簿人氣自行估算收益或點數成本。\n\n`preview_generate` 不是付費 customer-generation 產品；它只允許 owner 使用，永遠記錄零點數成本，消耗既有、有上限的每日 Painter preview quota 一單位，並同時回傳 `cost` 與剩餘 `quota`。用 `get_generation` 輪詢，再以 `promote_preview_result` 把已完成的 managed asset 綁為封面或圖庫圖片。付費 customer `generate` route、reviews、favourites 與 reports 都不是 Painter Actions。刪除相簿或圖片需要 UserConfirm + Strict drift；所有 Painter Actions 都只能在 private conversation 使用。\n",
  "aliases": [
    "Painter 相簿",
    "創作者圖片相簿",
    "相簿價格",
    "Painter 預覽",
    "圖庫圖片",
    "創作者收益"
  ],
  "tags": [
    "painter",
    "creator",
    "album",
    "pricing",
    "usage",
    "preview"
  ],
  "relatedActions": [
    "arinova.painter.list_albums",
    "arinova.painter.create_album",
    "arinova.painter.get_album",
    "arinova.painter.update_album",
    "arinova.painter.delete_album",
    "arinova.painter.list_image_models",
    "arinova.painter.set_album_cover",
    "arinova.painter.update_image",
    "arinova.painter.delete_image",
    "arinova.painter.get_stats",
    "arinova.painter.preview_generate",
    "arinova.painter.promote_preview_result",
    "arinova.painter.get_generation",
    "arinova.painter.list_generations"
  ],
  "relatedActionPrefixes": [
    "arinova.painter."
  ],
  "url": "https://docs.arinova.ai/zh-tw/kb/painter/overview/"
}
---

`painter` family 是創作者自有相簿切片。它能列出、建立、檢視、更新與經確認後刪除相簿；檢視支援的圖片模型；把既有 managed gallery image 設為封面；更新或經確認後刪除圖庫圖片 metadata；以及讀取 owner-only 統計。封面與圖庫的 multipart 上傳仍保留為 REST endpoint。新相簿一律從 draft 開始；publication 更新仍會通過現有 readiness 與 safety review gate，付費相簿價格也由 server 驗證。

`get_stats` 會回傳相簿價格、customer generation 數量、近期趨勢、reviews 與 creator wallet 淨收益。`get_album` 包含目前價格與每日 quota projection。`list_generations` 與 `get_generation` 提供 owner-scoped 用量歷史，內含已儲存的 cost、refund state、status 與 result asset。這些 live values 才是權威來源，不要從相簿人氣自行估算收益或點數成本。

`preview_generate` 不是付費 customer-generation 產品；它只允許 owner 使用，永遠記錄零點數成本，消耗既有、有上限的每日 Painter preview quota 一單位，並同時回傳 `cost` 與剩餘 `quota`。用 `get_generation` 輪詢，再以 `promote_preview_result` 把已完成的 managed asset 綁為封面或圖庫圖片。付費 customer `generate` route、reviews、favourites 與 reports 都不是 Painter Actions。刪除相簿或圖片需要 UserConfirm + Strict drift；所有 Painter Actions 都只能在 private conversation 使用。