Use this key in your API requests (X-API-Key header) or widget initialization.
Keep it secure and do not share it publicly.
Link the Google Sheet that lists the products you want available in your widget. Updating this only saves the link — pull the new product list with Sync now on the My Products tab.
Open the sheet in Google Sheets and copy the long ID from the URL: /spreadsheets/d/SHEET_ID/edit. The sheet must be shared as Anyone with the link — Viewer.
You can integrate the OEMBuilder API into your site three ways: JavaScript SDK (most flexible), iframe Embed (easiest), or REST API (full control). Copy the snippets below and adapt them to your project.
Add the SDK to your page, initialize it with your API key, and call generate() to render an image. The response includes image_url and a cached flag.
// Add the SDK to your page <script src="https://builder.uptakeagency.com/widget/oembuilder.js"></script> // Initialize with your API key OEMBuilder.init({ apiKey: 'YOUR_API_KEY' }); // Generate an image const result = await OEMBuilder.generate({ components: [ { type: 'case', product_code: 'MAG-PANO-M100R-PZ' }, { type: 'motherboard', product_code: 'MPG-Z790-CARBON-WIFI' }, { type: 'gpu', product_code: 'RTX-4060-GAMING-X-8G' } ] }); // Use the result console.log(result.image_url); // /cache/abc123.jpg console.log(result.cached); // true/false
The fastest integration. Drop the iframe into your page; your customers pick parts in the embedded UI and generate images. It blends into your site's design.
<!-- Add this to your page; replace the key parameter --> <iframe src="https://builder.uptakeagency.com/embed/?key=YOUR_API_KEY" width="100%" height="600" frameborder="0" style="border-radius: 8px;" ></iframe>
For full control, call the API directly. Authenticate via the X-API-Key header. Use GET /api/products to list available products, and POST /api/generate to render an image.
# List available products curl https://builder.uptakeagency.com/api/products # Generate an image curl -X POST https://builder.uptakeagency.com/api/generate \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{ "components": [ {"type": "case", "product_code": "MAG-PANO-M100R-PZ"}, {"type": "gpu", "product_code": "RTX-4060-GAMING-X-8G"} ] }' # Response { "success": true, "image_url": "/cache/abc123def456.jpg", "cached": false }
/api/products endpoint.
Each category (case, motherboard, gpu, cooler, psu, ssd, accessory) has its own products.
Your AI generation activity. Cache hits don't consume credits — repeat builds are served instantly from disk and are always free.
Your most recent AI-generated builds. Click an image to view it full size.