---
{
  "id": "platform.painter.overview",
  "topic": "painter",
  "title": "Creator-owned Painter albums, pricing, usage, and previews",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Painter Actions manage the Agent owner's creator albums while keeping paid customer generation outside the Agent surface.",
  "content": "The `painter` family is the creator-owned album slice. It can list, create, inspect, update, and confirmed-delete albums; inspect supported image models; select a managed gallery image as cover; update or confirmed-delete gallery image metadata; and read owner-only statistics. Multipart cover and gallery uploads remain REST endpoints. Album creation starts as a draft. Publication updates still pass the existing readiness and safety-review gates, and paid album pricing is validated by the server.\n\n`get_stats` returns the album's price, customer generation counts, recent trend, reviews, and net creator-wallet revenue. `get_album` includes the current price and daily quota projection. `list_generations` and `get_generation` expose owner-scoped usage history with the stored cost, refund state, status, and result asset. Treat these live values as authoritative; do not estimate revenue or point cost from album popularity.\n\n`preview_generate` is not the paid customer-generation product. It is owner-only, always records a zero point cost, consumes one unit from the existing bounded daily Painter-preview quota, and returns both `cost` and remaining `quota`. Poll it with `get_generation`, then use `promote_preview_result` to bind a completed managed asset as the cover or a gallery image. The paid customer `generate` route, reviews, favourites, and reports are not Painter Actions. Album and image deletion require UserConfirm with Strict drift; every Painter Action is private-conversation only.\n",
  "aliases": [
    "Painter album",
    "creator image album",
    "album pricing",
    "Painter preview",
    "gallery image",
    "creator revenue"
  ],
  "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/en/kb/painter/overview/"
}
---

The `painter` family is the creator-owned album slice. It can list, create, inspect, update, and confirmed-delete albums; inspect supported image models; select a managed gallery image as cover; update or confirmed-delete gallery image metadata; and read owner-only statistics. Multipart cover and gallery uploads remain REST endpoints. Album creation starts as a draft. Publication updates still pass the existing readiness and safety-review gates, and paid album pricing is validated by the server.

`get_stats` returns the album's price, customer generation counts, recent trend, reviews, and net creator-wallet revenue. `get_album` includes the current price and daily quota projection. `list_generations` and `get_generation` expose owner-scoped usage history with the stored cost, refund state, status, and result asset. Treat these live values as authoritative; do not estimate revenue or point cost from album popularity.

`preview_generate` is not the paid customer-generation product. It is owner-only, always records a zero point cost, consumes one unit from the existing bounded daily Painter-preview quota, and returns both `cost` and remaining `quota`. Poll it with `get_generation`, then use `promote_preview_result` to bind a completed managed asset as the cover or a gallery image. The paid customer `generate` route, reviews, favourites, and reports are not Painter Actions. Album and image deletion require UserConfirm with Strict drift; every Painter Action is private-conversation only.