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": "Create a leaderboard banner ad visual for a SaaS product launch. Clean gradient from dark navy to royal blue, abstract dashboard wireframe fading in from the right side, modern tech aesthetic, 728x90 pixel proportions, space on the left for headline text and CTA button."
      }
    ],
    "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": "Create a leaderboard banner ad visual for a SaaS product launch. Clean gradient from dark navy to royal blue, abstract dashboard wireframe fading in from the right side, modern tech aesthetic, 728x90 pixel proportions, space on the left for headline text and CTA button."
    }]
)

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

With Reference Image

Use brand assets or previous ad creatives as style reference:

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": "Create a banner ad background matching this brand style. Same color palette and visual language, medium rectangle format 300x250 proportions, leave space for product image overlay and CTA button."},
              {"type": "image_url", "image_url": {"url": "https://example.com/brand-guidelines.jpg"}}
            ]
          }
    ],
    "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.

Standard IAB Ad Sizes

Name	Size	Use Case
Leaderboard	728 x 90	Top of page
Medium Rectangle	300 x 250	Sidebar, in-content
Wide Skyscraper	160 x 600	Sidebar
Half Page	300 x 600	High-impact sidebar
Large Rectangle	336 x 280	In-content
Billboard	970 x 250	Premium top placement
Mobile Leaderboard	320 x 50	Mobile apps
Large Mobile	320 x 100	Mobile web

Prompt Engineering Tips

Keywords That Work

banner ad visual, clean layout, bold focal point, high contrast CTA area,
brand-consistent, product spotlight, clear visual hierarchy, professional,
space for text overlay, call-to-action area, conversion-focused

Keywords to Avoid

cluttered with text — add copy in design software
too many products — one focal point per ad
subtle and understated — ads need to stand out
small intricate details — banners are viewed at actual size

Prompt Structure

banner ad visual for [product/service], [background/style], [focal element], [color scheme], [size proportions], space for [text/CTA placement]

Examples

E-commerce Product Ad

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": "Design a medium rectangle banner ad background for a luxury watch sale. Rich black background with subtle gold sparkle particles, dramatic spotlight in the center for product placement, premium and elegant, 300x250 proportions."
      }
    ],
    "stream": false
  }'

Travel Campaign Ad

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": "Create a half page banner ad for a tropical travel deal. Stunning turquoise ocean fading into white sand beach, palm tree framing the left edge, warm golden sunlight, aspirational and inviting, 300x600 proportions with a dark overlay at the bottom for deal text."
      }
    ],
    "stream": false
  }'

App Download Ad

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": "Design a mobile leaderboard banner for a fitness app. Energetic gradient from orange to magenta, abstract motion lines suggesting speed and movement, clean modern tech style, 320x100 proportions with phone mockup area on the right."
      }
    ],
    "stream": false
  }'

Banner Ad Best Practices

One message per banner — do not try to communicate multiple ideas
Clear visual hierarchy — image, headline, CTA in that order
High contrast CTA area — the call-to-action must pop against the background
Brand consistency — use the same visual language across all ad sizes
File size matters — keep final files under 150KB for fast loading
Border recommended — a 1px border helps the ad stand out on white pages

Workflow

# Step 1: Generate the primary ad creative (medium rectangle)
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": "Banner ad background for a fintech app. Deep indigo to teal gradient, abstract floating coins and upward arrows made of light particles, futuristic and trustworthy, 300x250 proportions."
      }
    ],
    "stream": false
  }'

# Step 2: Adapt to leaderboard format
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": "Banner ad background for a fintech app. Deep indigo to teal gradient, abstract floating coins and upward arrows made of light particles, futuristic and trustworthy, 300x250 proportions."
      },
      {
        "role": "assistant",
        "content": "..."
      },
      {
        "role": "user",
        "content": "Now adapt this same visual concept to a leaderboard format, 728x90 proportions. Stretch the gradient horizontally, place the light particle elements on the right side, leave the left half clean for text."
      }
    ],
    "stream": false
  }'

banner-ad-design

Banner Ad Design

Quick Start

Using curl