curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Generate a product mockup: a kraft paper coffee bag with a minimalist mountain logo standing on a rustic wooden shelf next to a ceramic pour-over dripper and a small potted succulent. Warm morning light from the right, cozy coffee shop atmosphere, commercial mockup photography quality"
      }
    ],
    "stream": false
  }'

Using Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_EACHLABS_API_KEY",
    base_url="https://eachsense-agent.core.eachlabs.run/v1"
)

response = client.chat.completions.create(
    model="eachsense/beta",
    messages=[{
        "role": "user",
        "content": "Generate a product mockup: a kraft paper coffee bag with a minimalist mountain logo standing on a rustic wooden shelf next to a ceramic pour-over dripper and a small potted succulent. Warm morning light from the right, cozy coffee shop atmosphere, commercial mockup photography quality"
    }]
)

print(response.choices[0].message.content)

With Reference Image

Provide your design or product to place into a mockup scene:

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": [
              {"type": "text", "text": "Place this product design onto a realistic mockup. Show the product on a clean marble countertop with soft studio lighting, lifestyle context props (a small plant and a glass of water), and a blurred modern kitchen background. Commercial mockup quality."},
              {"type": "image_url", "image_url": {"url": "https://example.com/my-product-design.png"}}
            ]
          }
    ],
    "stream": false
  }'

Images are sent inside messages using the OpenAI multimodal content format. Maximum 4 images per request.

Streaming

Set "stream": true for real-time SSE responses, or "stream": false for complete result in a single response. Streaming is useful for showing progress in UIs; non-streaming is simpler for scripts and automation.

Mockup Categories

Category	Mockup Types	Use Case
Apparel	t-shirt, hoodie, hat, tote bag	print-on-demand, merch
Drinkware	mug, tumbler, water bottle, glass	print-on-demand, gifts
Packaging	box, bag, bottle, jar, tube, pouch	CPG brands, food/beverage
Print	business card, poster, book, magazine	branding, publishing
Devices	phone screen, laptop, tablet, monitor	app/web design
Signage	storefront sign, banner, billboard	retail, OOH advertising
Stationery	letterhead, envelope, notebook, pen	corporate branding

Prompt Engineering Tips

Prompt Structure

"Generate a product mockup:" + [product description with design] + [surface/placement] + [scene context and props] + [lighting] + [atmosphere/mood] + [quality keywords]

Surface and Placement Keywords

on a flat marble surface, hanging on a clothesline,
displayed on a retail shelf, held in a person's hand,
standing on a desk, mounted on a wall, placed on grass,
floating with soft shadow, arranged in a flat lay

Scene Mood Keywords

clean and minimal, cozy and warm, rustic artisan,
modern corporate, outdoor adventure, luxury premium,
playful and colorful, dark and moody

Examples

T-Shirt Mockup

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Generate a t-shirt mockup: a black crew-neck t-shirt with a large vintage-style retro sunset graphic on the front, displayed on an invisible mannequin form. Clean light grey background, soft studio lighting, slight wrinkle detail for realism, front view, print-on-demand listing quality."
      }
    ],
    "stream": false
  }'

Candle Packaging Scene

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Generate a product mockup: a luxury soy candle in an amber glass jar with a minimal white label, sitting on a raw-edge wooden tray alongside dried pampas grass, a matchbox, and a linen napkin. Warm soft candlelight glow, dark moody background, shallow depth of field, premium lifestyle mockup photography."
      }
    ],
    "stream": false
  }'

Mobile App on Device

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Generate a device mockup: a modern smartphone displaying a fitness tracking app with green and dark UI elements on the screen. The phone is placed on a light wooden desk next to wireless earbuds, a smartwatch, and a water bottle. Morning light, clean modern aesthetic, tech product mockup quality."
      }
    ],
    "stream": false
  }'

Book Cover Mockup

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Generate a book mockup: a hardcover book with a dark navy cover and gold foil abstract design, standing upright on a walnut bookshelf. Two more copies stacked flat behind it. A reading lamp and small vintage clock as props. Warm golden library lighting, shallow depth of field, publisher marketing mockup quality."
      }
    ],
    "stream": false
  }'

Batch Workflow: Brand Touchpoints

BRAND="a minimalist skincare brand with clean white packaging, sans-serif typography, and sage green accent color"

MOCKUPS=(
  "a tube of face cream on a white marble bathroom shelf, morning light, clean minimal"
  "a serum bottle held in a woman's hand with a blurred spa background, natural lighting"
  "a gift set box with three products inside, displayed on a white bed with linen sheets, bright and airy"
  "the brand's shopping bag on a store counter with tissue paper peeking out, boutique atmosphere"
  "a flat lay of all products arranged symmetrically on a sage green background with botanical props, overhead shot"
)

for MOCKUP in "${MOCKUPS[@]}"; do
  curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "X-API-Key: $EACHLABS_API_KEY" \
    -d "{
      \"messages\": [{\"role\": \"user\", \"content\": \"Generate a product mockup for $BRAND: $MOCKUP. Commercial mockup photography quality.\"}],
      \"stream\": false
    }"
  echo "---"
done

Common Pitfalls

Text and logos on products will not render accurately. AI struggles with specific words and fine typography. Use the mockup as a base and composite your real design in post.
Brand consistency — AI generates different products each time. Describe the product identically for each mockup.
Unrealistic scale — a product that is too large or small for the scene looks fake. Mention size relative to props.
Busy backgrounds competing with the product — the product should always be the clear focal point.
Shadow and reflection mismatches — specify light direction to keep shadows consistent with the scene.

ai-product-mockup

AI Product Mockup

Quick Start

Using curl