REST API v1

AssetForge Documentation

Generate production-ready SVGs, PNGs, ICOs, and brand asset packages on demand. Built for AI agents, automated pipelines, and developers.

API Reference

Endpoints, auth, request/response schemas, and rate limits.

CLI

Install and use the AssetForge CLI for local generation.

SVG Generation

Vector graphics with full color and dimension control.

Favicon Package

Complete favicon sets: ICO, PNG, manifests, and meta tags.

Getting Started

1. Get an API key

2. Make your first request

Pass your API key in the Authorization header:

bash

curl -X POST https://assetforge.io/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "minimalist tech startup logo",
    "formats": ["svg", "png", "ico"],
    "width": 512,
    "height": 512
  }'

3. Download your assets

The API returns a job ID. Poll the status endpoint to get download URLs once generation is complete:

bash

curl https://assetforge.io/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

json

{
  "id": "job_1a2b3c4d",
  "status": "complete",
  "assets": [
    { "format": "svg",  "url": "https://cdn.assetforge.io/..." },
    { "format": "png",  "url": "https://cdn.assetforge.io/..." },
    { "format": "ico",  "url": "https://cdn.assetforge.io/..." }
  ],
  "duration_ms": 843
}

Authentication

All API requests must include your API key in the Authorization header as a Bearer token.

http

Authorization: Bearer af_live_xxxxxxxxxxxxxxxxxxxx

KEY PREFIXES

af_live_ — production API key
af_test_ — test key (free, no billing)

Rate Limits

Rate limits are enforced per API key. Exceeded limits return 429 Too Many Requests.

Plan	Requests / month	Concurrent
Free	100	2
Pro	50,000	20
Enterprise	Unlimited	100+

SDKs & Integrations

Use AssetForge from any environment:

CLI

npm install -g assetforge

Node.js

npm install @assetforge/sdk

Python

pip install assetforge

Also available as an MCP server for use directly inside AI agents.