# 3DPAKS Full API & Autonomous Agent Specification

> 3DPAKS is a free, parametric 3D packaging mockup and structural dieline engine.
> Photorealistic packaging rendered from true millimetre specifications rather than text prompts.

## Core Endpoints

1. GET /api/forms
Returns the entire library of packaging models, physical dimensions, category, and 150 DPI artwork canvas sizes.

2. GET /api/schema
Returns the JSON Schema specification for configuring scenes (packaging shapes, materials, closures, labels, liquids, and camera views).

3. POST /api/scene
Input: { "prompt": "330ml craft beer bottle with matte black crown seal and amber glass" }
Output: Full SceneSpec object.

4. GET /api/defaults
Returns default scene specification.

## Packaging Categories & Forms Supported

- Cans: beverage-can-330ml, beverage-can-500ml, beverage-can-generic, energy-drink-can
- Bottles: beer-bottle-crown, beer-longneck-glb, wine-bottle-cork, wine-bottle-screwcap, iced-tea-bottle, soda-bottle-condensation
- Cartons: tuck-top-box (FEFCO 0211), milk-pack, cereal-box, mailer-box
- Pouches: foil-hanging-pouch, coffee-pouch, sachet-bag
- Tins & Jars: food-tin-medium, food-tin-squat, food-tin-tall, honey-jar, ice-cream-tub
- Tubes: cream-tube, hand-cream-bottle

## 150 DPI Physical Label Calculation Rule
Artwork width (pixels) = (Wrap perimeter mm / 25.4) * 150
Artwork height (pixels) = (Label height mm / 25.4) * 150