AI Brand Guideline Kit API

Turn your logo, website, product photos or a short description into complete brand guidelines. Start with a free brand snapshot you can edit (palette, fonts, logo, personality, voice), then get a 21-page brand book PDF covering your story, voice and tone, logo rules, colour system with accessible contrast, typography and imagery, plus business card, social post, story, website hero and email signature mockups with your real logo. The download kit adds logo files and favicons, CSS variables, design tokens, a Tailwind theme and a brand file for AI writing tools. One click saves it to your Brand Kit so every AADDYY writing tool uses your voice.

design tools49 creditsv1.0.0

Schema

LLMs

Open Markdown content Open in ChatGPT Open in Claude

Endpoint

endpoint

POST https://backend.aaddyy.com/api/ai/brand-guideline-kit

Authentication

header

Authorization: Bearer YOUR_API_KEY

Parameters

Optional

analysisIdstring

Id from POST /api/ai/brand-guideline-kit/analyze (free snapshot, multipart or JSON). Use it with overrides to build the kit the user reviewed. Without it, pass the inputs below and the snapshot runs inline.

overridesobject

Edits to the snapshot: name, description, audience, tone, industry, language, personality (array), palette ({ primary, secondary, accent, neutralDark, neutralLight } hex), fonts ({ heading, body }).

businessNamestring

Brand name. With a description, it is enough on its own; otherwise give websiteUrl, logoUrl, productImageUrls or fromBrandKit.

descriptionstring

What the business does and for whom (20-500 characters). Needed with businessName when no other source is given.

websiteUrlstring

Public website to read colours, fonts, logo and copy from (homepage plus one about page). Any one source is enough: businessName with a description, websiteUrl, logoUrl, productImageUrls or fromBrandKit.

logoUrlstring

Public link to the logo (PNG, JPG, WebP or SVG, up to 10 MB). Any one source is enough: businessName with a description, websiteUrl, logoUrl, productImageUrls or fromBrandKit.

productImageUrlsarray

Up to 4 public links to product photos (PNG, JPG or WebP). Any one source is enough: businessName with a description, websiteUrl, logoUrl, productImageUrls or fromBrandKit.

fromBrandKitstring

'true' to start from your default saved Brand Kit, or a kit id. Any one source is enough: businessName with a description, websiteUrl, logoUrl, productImageUrls or fromBrandKit.

industrystring

The first 60 characters are used.

audiencestring

personalityarray

Up to 3 personality words, such as warm, bold, precise.

keepColorsarray

Up to 3 hex colours that must stay in the palette.

keepFontsarray

Up to 2 font names to keep (heading, body).

languagestring

Language for taglines and sample copy.

Values: EnglishHindiHinglishMarathiSpanishFrenchGermanPortugueseItalianDutchIndonesianMalaySwahiliTagalog

Default: English

ownsBrandboolean

Required (true) unless you pass analysisId: you own or represent this brand.

Example Request

cURL

curl -X POST https://backend.aaddyy.com/api/ai/brand-guideline-kit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Request Body

json

{}

Example Response

json

{
  "success": true,
  "message": "AI Brand Guideline Kit completed successfully",
  "timestamp": "2026-11-08T15:22:10.984Z",
  "requestId": "req_hfjzbz3k2",
  "data": {
    "cost": 0.49,
    "remainingCredits": 9.95
  }
}

SDK

javascript

import { AADDYY } from 'aaddyy'

const client = new AADDYY()
const result = await client._request('POST', '/api/ai/brand-guideline-kit', {})

Install: npm install aaddyy

Pricing

$0.49 per use (49 credits)

flat price per brand guidelines kit; the brand snapshot before it is free (5 a day)

Rate Limits

5 requests per 1m

Burst: 2

← Back to all endpoints