VR9 AdKit API

curl -X POST "https://adkit.vr9.pro/api/v1/public/cards" \
  -H "Authorization: Bearer $ADKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seller_id": "seller-1042",
    "card_type": "product",
    "title": "Leather weekender bag",
    "tagline": "Full-grain leather, brass hardware, built for 20 years",
    "aspect_ratio": "4:5",
    "attributes": [
      {"label": "Price", "value": "$249", "icon": "price-tag"},
      {"label": "Ships in", "value": "2 days", "icon": "truck"},
      {"label": "Handmade", "icon": "star"}
    ],
    "image_urls": ["https://cdn.example.com/products/1042/front.jpg"]
  }'

curl -X POST "https://adkit.vr9.pro/api/v1/public/cards/upload" \
  -H "Authorization: Bearer $ADKIT_API_KEY" \
  -F 'payload={"seller_id":"seller-1042","card_type":"product","title":"Leather weekender bag","tagline":"Full-grain leather, brass hardware"}' \
  -F "images=@front.jpg" \
  -F "images=@side.jpg" \
  -F "avatar=@logo.png"

const res = await fetch("https://adkit.vr9.pro/api/v1/public/cards", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ADKIT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    seller_id: "seller-1042",
    card_type: "service",
    title: "Same-day bike repair",
    tagline: "Brakes, gears and tyres — fixed while you wait",
    attributes: [
      { label: "From", value: "$29", icon: "price-tag" },
      { label: "Duration", value: "45 min", icon: "clock" },
      { label: "Location", value: "Berlin, Mitte", icon: "location" },
    ],
    background_prompt: "a bright bicycle workshop, tools on a pegboard",
  }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const card = await res.json();
// card.image_base64 -> "data:image/png;base64,..." ; card.from_scratch === true

import base64
import requests

BASE = "https://adkit.vr9.pro/api/v1"
HEADERS = {"Authorization": f"Bearer {ADKIT_API_KEY}"}


def render_catalogue(seller: dict, products: list[dict]) -> None:
    for product in products:
        body = {
            "seller_id": seller["id"],       # one look for the whole seller
            "palette_mode": "seller",        # ...including the colours
            "card_type": "product",
            "title": product["name"],
            "tagline": product["short_description"],
            "attributes": [
                {"label": "Price", "value": product["price"], "icon": "price-tag"},
            ],
            "image_urls": product["photo_urls"],  # [] -> background is generated
        }
        r = requests.post(f"{BASE}/public/cards", headers=HEADERS, json=body, timeout=120)

        if r.status_code == 503:             # renderer busy: saved as a draft, nothing charged
            retry_path = r.json()["detail"]["retry_path"]
            r = requests.post(f"{BASE}{retry_path.removeprefix('/api/v1')}", headers=HEADERS, timeout=120)

        r.raise_for_status()
        card = r.json()
        png = base64.b64decode(card["image_base64"].split(",", 1)[1])
        with open(f"cards/{product['id']}.png", "wb") as f:
            f.write(png)
        print(product["id"], card["style"], card["token_balance"])

{
  "id": "0f1c9d2e-5b7a-4c3e-9f1d-2a6b8c4d7e90",
  "image_url": "/api/v1/public/cards/0f1c9d2e-5b7a-4c3e-9f1d-2a6b8c4d7e90/image.png",
  "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "width": 2560,
  "height": 3200,
  "style": {
    "skeleton": "split-hero",
    "palette": "linen-coral",
    "font_pair": "modern-sans",
    "accent": "clean",
    "framing": "rounded",
    "attribute_partial": "partials/attributes_spec_grid.html.jinja"
  },
  "from_scratch": false,
  "tokens_charged": 1,
  "token_balance": 41
}

HTTP/1.1 503 Service Unavailable
{
  "detail": {
    "code": "render_unavailable",
    "draft_id": "5b2e7c1a-9d4f-4e8b-a3c6-1f0d2e9b7a54",
    "attempts": 3,
    "retry_path": "/api/v1/public/cards/drafts/5b2e7c1a-9d4f-4e8b-a3c6-1f0d2e9b7a54/render",
    "message": "The renderer is busy. Your card is saved as a draft and no tokens were charged — retry it with POST /api/v1/public/cards/drafts/5b2e7c1a-.../render."
  }
}