Blueprint Studio API v1

Authentication

All API requests require an API key sent via the Authorization header.

curl https://tools.blueprintstudio.ai/api/v1/assets \
  -H "Authorization: Bearer bp_live_your_api_key_here"

Create API keys in your account settings. Keys are hashed on our servers — save your key when first created.

Rate Limits

Rate limit headers are included in every response. When exceeded, you'll receive a 429 status with a Retry-After header.

Quick Start

Generate your first asset in one request:

curl -X POST https://tools.blueprintstudio.ai/api/v1/generate \
  -H "Authorization: Bearer bp_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a minimalist coffee cup icon"}'

Generation

Generate brand assets, get prompt suggestions, and brainstorm ideas using AI.

Assets

List, retrieve, delete, favorite, share, and remove backgrounds from generated assets.

Styles

Manage visual styles — list, create, update, delete custom styles, analyze images for style extraction, and manage reference images.

Brands

Manage brands (organizations) — create, update, delete, manage settings, upload logos, and analyze websites for brand identity.

Auth

Register a new account. No authentication required.

API Keys

Manage API keys — list active keys, create new ones, and revoke existing keys.

Settings

Get and update user-level settings like default style and prompt template.

Usage

Check current usage, rate limits, and remaining quotas.

Error Codes