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 book cover for a psychological thriller novel. A lone figure standing at the end of a foggy pier at night, dark moody atmosphere, desaturated blue-green tones, cinematic lighting from a single distant lamppost, ominous and suspenseful, portrait orientation."
      }
    ],
    "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": "Design a book cover for a psychological thriller novel. A lone figure standing at the end of a foggy pier at night, dark moody atmosphere, desaturated blue-green tones, cinematic lighting from a single distant lamppost, ominous and suspenseful, portrait orientation."
    }]
)

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

With Reference Image

Provide genre references or mood boards to guide the style:

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 book cover in a similar artistic style to this reference but for a fantasy epic. Replace the subject with a towering crystal castle surrounded by floating islands, keep the painterly quality and dramatic sky."},
              {"type": "image_url", "image_url": {"url": "https://example.com/style-reference.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.

Genre Style Guide

Genre	Visual Style	Colors	Mood
Thriller/Mystery	Dark, high contrast	Deep blues, blacks, reds	Tension, suspense
Romance	Soft, warm, intimate	Pinks, golds, warm tones	Passion, longing
Sci-Fi	Futuristic, dramatic	Neon blues, purples, silvers	Wonder, technology
Fantasy	Epic, painterly	Rich jewel tones	Magic, adventure
Literary Fiction	Minimalist, symbolic	Muted, sophisticated	Contemplation
Business/Self-Help	Clean, bold	Strong single color + white	Authority, clarity
Horror	Gritty, unsettling	Dark reds, blacks, sickly greens	Dread, fear
Children's	Bright, whimsical	Primary colors, pastels	Joy, wonder

Prompt Engineering Tips

Keywords That Work

book cover art, portrait orientation, cinematic composition, dramatic lighting,
painterly illustration, atmospheric mood, symbolic imagery, single focal point,
genre-appropriate, space for title text at top, author name area at bottom

Keywords to Avoid

text on the cover — add title and author in design software
landscape orientation — books are portrait
cluttered composition — covers need visual hierarchy
photorealistic people — uncanny valley risk

Prompt Structure

book cover for [genre] [type], [scene/subject description], [artistic style], [color palette], [mood/atmosphere], portrait orientation

Examples

Science Fiction Novel

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 sci-fi book cover. An astronaut floating in the rings of Saturn, seen from behind, tiny against the massive planet, stars and cosmic dust swirling around, deep space blues and warm amber planet light, epic and solitary, portrait orientation."
      }
    ],
    "stream": false
  }'

Literary Fiction

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 minimalist literary fiction book cover. A single red door standing alone in an endless white desert, long shadow stretching toward the viewer, surreal and contemplative, muted earth tones with one pop of deep red, portrait orientation."
      }
    ],
    "stream": false
  }'

Business Book

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 business book cover. Abstract geometric mountain peak made of interconnected data nodes and lines, navy blue background fading to white at the top, clean and professional, corporate yet inspiring, portrait orientation with ample space for a large title."
      }
    ],
    "stream": false
  }'

Important: Text on Covers

AI image generators cannot reliably render text. Always plan to add title, subtitle, and author name in post-production.

Recommended workflow:

Generate the cover artwork only with each::sense
Add typography in a design tool (Canva, InDesign, Photoshop)
Use the upper third for the title and lower area for the author name

Standard Cover Dimensions

Format	Size
Amazon Kindle	1600 x 2560 px
Print Paperback (6x9)	1800 x 2700 px
Audiobook	3200 x 3200 px
Apple Books	1400 x 1873 px

Workflow

# Step 1: Generate concept art
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": "Book cover for a fantasy novel. An ancient tree with roots made of glowing runes, mystical forest background, ethereal green and gold light filtering through mist, portrait orientation."
      }
    ],
    "stream": false
  }'

# Step 2: Refine the artwork
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": "Book cover for a fantasy novel. An ancient tree with roots made of glowing runes, mystical forest background, ethereal green and gold light filtering through mist, portrait orientation."
      },
      {
        "role": "assistant",
        "content": "..."
      },
      {
        "role": "user",
        "content": "Darken the upper third of the image to create space for a light-colored title. Make the rune glow brighter and add fireflies in the mist."
      }
    ],
    "stream": false
  }'

book-cover-design

Book Cover Design

Quick Start

Using curl