Price it: run one card

The price for exactly this body, the balance beside it and any notes. Nothing runs and nothing is charged. Run it with POST /api/v1/boards/{boardId}/cards/{cardId}/run, the same body, confirmCredits set to credits and the same Idempotency-Key.

Key needs: create · Make things and spend credits
Runs it: POST /boards/{boardId}/cards/{cardId}/run
Answers: A quote · free

Request

curl -X POST https://vessero.com/api/v1/boards/0b6f3c1e-2d4a-4b5c-8d9e-0f1a2b3c4d5e/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/run/quote \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{}'

Response200 OK

{
  "object": "quote",
  "credits": 12,
  "balance": 840,
  "lines": [
    "1 image × 12 (Nano Banana Pro · 4K)"
  ],
  "notes": [],
  "requestId": "47f8f6f5-ea00-4fb1-925f-76aac956a0ec",
  "run": {
    "method": "POST",
    "path": "/api/v1/images",
    "confirmCredits": 12,
    "idempotencyKey": "47f8f6f5-ea00-4fb1-925f-76aac956a0ec"
  }
}

Path

boardIdstringrequired—
cardIdstringrequired—

Header

Idempotency-KeystringYour id for this request: 8–64 letters, digits, - or _. A repeat within 10 minutes gets the first answer back and never runs twice. Use the same one for the quote and the run.

Body

takesintegerHow many takes, 1–4, each priced as one. Default 1.
upgradeDraftbooleanTrue: make the draft the card shows sharp, rather than run the card again. Takes no takes.

Answers

200quoteThe price for exactly this body, your balance and any notes. Nothing ran.
400invalid_requestA field is missing or not accepted: see details.
403feature_unavailableThe studio this needs is switched off for the account right now.
429rate_limitedToo many calls this minute: see Retry-After.

Next in Creative BoardPOST/boards/{boardId}/cards/{cardId}/duplicateCopy a card