API Docs

Overview

The product API lives under /wp-json/aerokit/v1/. Logged-in website sessions already call these routes. Business includes API access for factories and sellers who want the same generate / optimize flow from their own tools. Contact us for a server integration — we do not publish long-lived public keys on this page.

https://aerokitai.com/wp-json/aerokit/v1

Authentication

• Browser clients: WordPress login cookie plus the X-WP-Nonce header from the page.
• Same-origin requests from aerokitai.com are accepted for the studio.
• Generation, Local Edit, and gallery downloads require a signed-in user with remaining credits (Business is unlimited).

Credits

• mode=quick or prompt with count=1 spends 1 design.
• count=4 spends 4 designs.
• mode=edit (Local Edit) spends 1 design.
• Free caps reset on the 1st. Pro 100 designs last until the subscription expires. 429 is returned if you burst the short-term rate limit.

POST /generate

Create kit concepts from an uploaded vehicle photo. Image must be a data URI (JPEG/PNG). Max payload is about 12MB; compress toward 4MB when possible.

POST https://aerokitai.com/wp-json/aerokit/v1/generate
Content-Type: application/json
X-WP-Nonce: <wp_rest nonce>

{
  "image": "data:image/jpeg;base64,...",
  "mode": "quick",
  "style": "Sport Aero",
  "prompt": "",
  "count": 4
}

mode: quick | prompt | edit. style: Sport Aero | Carbon Race | OEM Clean | Widebody Stance. Prompt Mode sends your text in prompt. Local Edit also sends a mask. Success returns images[] (URLs or data) and an updated account object.

POST /optimize

Expands a short Prompt Mode note into a production-oriented kit description before generate. Same auth as generate. Send { "prompt": "deeper front lip, compact canards" }.

Gallery

• GET /plaza — public list. Query sort=top|new, page, per_page, optional brand/model/year.
• GET /plaza/item?id= — one kit, including notes.
• POST /plaza/share — publish a generated concept (logged in).
• GET /plaza/download?id= — file download, logged in only.

Errors