Credits and quotes

Agents and scripts spend the connected workspace's credits, at the same prices as the web app. Nothing is ever spent without a quote that was confirmed, or an explicit auto_confirm in a REST call.

PricesCopy Anchor Link

list_edit_options (GET /v1/edit-options) returns the current prices as credit_costs. Jobs that fail are refunded automatically.

The quote → confirm flowCopy Anchor Link

1. Call a spending operation without quote_id. You get a quote: what will run, the credit cost, your balance before and after, and warnings such as a trial watermark. Nothing is spent.
2. Show the quote to the user.
3. Call the same operation with the same arguments plus quote_id. The work runs and you get job IDs.

A quote:

• lasts 10 minutes,
• can be used once,
• is bound to the connection and to the exact request. Change any argument and you get 409 quote_mismatch; request a new quote.
• with all_photos: true, covers the photos in the project when it was quoted. If photos are added or removed before you confirm, or the price goes up, confirming fails with 409 quote_mismatch.

Over MCP, the first call returns the quote as the tool result. ChatGPT shows it as a card with a Run button; other clients tell you the cost and wait for your yes.

Over REST, the first call returns 409 with code quote_required and the quote in the quote field. You can also price a request explicitly with POST /v1/quotes:

curl -s -X POST "$PP_API/quotes" \
  -H "Authorization: Bearer $PP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation": "stage_photos",
       "input": {"photo_ids": ["…"], "design_style": "modern", "variations": 2}}'

auto_confirm (REST only)Copy Anchor Link

Scripts that already know what they will spend can send "auto_confirm": true and skip the quote:

{ "photo_ids": ["…"], "enhancement_types": ["improve_lighting"], "auto_confirm": true }

Use it only in code you control. It works only with a personal API key: app (OAuth) connections and MCP always get a quote.

Not enough creditsCopy Anchor Link

If the balance can't cover a request, the quote says so (sufficient: false) and confirming it fails with 402 insufficient_credits. Add credits or change plan at propertypixel.app/settings/billing. Inside ChatGPT, PropertyPixel only tells you to manage your plan at propertypixel.app.

Trial accountsCopy Anchor Link

New accounts start with a free trial of 500 credits. Trial accounts can use every operation, but results carry a PropertyPixel watermark (watermarked: true on the quote and on each job), and some enhancement types need a paid plan. GET /v1/account shows the plan and whether results are watermarked.