Flatkey Image Prompt Library

English | 中文 | 日本語 | Español | Português | Tiếng Việt

Image Buddy is a commercial prompt library and CLI for generating useful marketing images with Flatkey.ai). Flatkey can be about 40% cheaper than common direct image API routes, and this repo makes it easier to turn that lower cost into usable product images, ads, avatars, app visuals, and ecommerce creatives.

Get API key: <https://flatkey.ai>

What You Get

• Lower generation cost: use Flatkey.ai for image generation, often around 40% cheaper than common direct API routes.
• Commercial prompts that work: templates are written for product, ecommerce, social ads, UI screenshots, avatars, posters, game assets, and edits.
• Fast generation demo: use image-buddy web to open a local demo gallery and generate images with a Flatkey key.
• CLI-first workflow: onboard once, then generate from a short sentence or a template hint.

Includes

Skill: a copy-paste prompt for your AI agent. The agent installs and uses Image Buddy for you, backed by the CLI.

Paste this into your AI assistant:

Install and use the Flatkey Image Buddy skill from https://github.com/flatkey-ai/awesome-images.
When I ask for an image, use image-buddy CLI with Flatkey. First run image-buddy onboard if needed, then generate the image from my short prompt or from a template hint. Do not stop at suggesting prompts.

CLI: one command-line tool for onboarding and generation.

• image-buddy onboard: save your Flatkey API key locally.
• image-buddy generate --prompt "...": generate from a plain sentence.
• image-buddy generate avatar-pack "地雷妹": generate from a template plus hint.
• image-buddy web: open the optional demo gallery.

Quickstart

Generate an image with no local install:

npx @flatkey-ai/image-buddy onboard
npx @flatkey-ai/image-buddy generate --prompt "premium product hero image for an AI image API CLI"

Use a template with a short hint:

npx @flatkey-ai/image-buddy generate avatar-pack "地雷妹"

Open the optional web gallery:

npx @flatkey-ai/image-buddy web

No API key yet? Create one at . The CLI reads the saved key, FLATKEY_IMAGE_API_KEY, or FLATKEY_API_KEY.

Why This Exists

• Lower activation friction: users start from proven templates instead of a blank prompt box.
• Increase API conversion: every template card sends users to Flatkey API key registration.
• Cover common commercial use cases: product marketing, ecommerce images, social ads, infographics, avatars, app screenshots, game assets, and image edits.
• Support batch workflows: templates use {{variable}} placeholders, so apps can replace values before sending final prompts to an API.
• Work as marketing content: useful as a prompt gallery, tutorial page, landing page, or onboarding resource.

Included Templates

This library currently includes 12 high-frequency image prompt templates:

• Premium product hero visual
• White-background ecommerce main image
• UGC ad cover frame
• Liquid glass Bento infographic
• Founder quote card
• Consistent avatar pack
• App Store screenshot poster
• YouTube thumbnail
• Event poster key visual
• Game prop concept sheet
• Subject-preserving background replacement
• Fashion lookbook collage

• Title and use case
• Category and recommended model
• Replaceable variables
• Full prompt text
• API use-case note
• Copy prompt button
• Flatkey API key registration link

Demo Gallery

The web gallery ships with 20 generated demo images. These are included in the npm package and shown by image-buddy web.

| Product | Ecommerce | Social Ad | App | |---|---|---|---| | !SaaS Hero Phone
SaaS Hero Phone | !Skincare Product
Skincare Product | !UGC Coffee Ad
UGC Coffee Ad | !Fitness App
Fitness App |

| Poster | Infographic | Fashion | Game Asset | |---|---|---|---| | !AI Agent Poster
AI Agent Poster | !Liquid Bento
Liquid Bento | !Streetwear Lookbook
Streetwear Lookbook | !Crystal Game Prop
Crystal Game Prop |

| Food | Travel | Portrait | Real Estate | |---|---|---|---| | !Dessert Hero
Dessert Hero | !Travel Map
Travel Map | !Cyber Portrait
Cyber Portrait | !Interior Render
Interior Render |

| Entertainment | Education | Finance | Beauty | |---|---|---|---| | !Music Cover
Music Cover | !Education Card
Education Card | !Finance Dashboard
Finance Dashboard | !Beauty Makeup
Beauty Makeup |

| Architecture | Pet | Sports | Publishing | |---|---|---|---| | !Architecture Model
Architecture Model | !Pet Brand
Pet Brand | !Sports Shoe
Sports Shoe | !Book Cover
Book Cover |

CLI Usage

Generate from plain English:

npx @flatkey-ai/image-buddy onboard
npx @flatkey-ai/image-buddy generate --prompt "premium product hero image for an AI image API CLI, clean SaaS style, teal accents, sharp commercial lighting"

Generate from a template:

npx @flatkey-ai/image-buddy onboard
npx @flatkey-ai/image-buddy generate avatar-pack "地雷妹"

For precise template control, pass variables explicitly:

npx @flatkey-ai/image-buddy generate premium-product-hero \
  --var "产品名称=Image Buddy" \
  --var "品牌调性=clean SaaS" \
  --var "核心卖点=one-command image generation" \
  --var "主色=teal" \
  --size 1536x1024

Template text after the id is used as a hint. Missing variables are filled from that hint, so users do not need to learn every --var name before generating.

onboard prompts for a Flatkey API key and saves it locally. If you do not have a key, get one at . The CLI also accepts FLATKEY_IMAGE_API_KEY or FLATKEY_API_KEY, calls Flatkey image generation, and saves images locally. No web server required.

generate defaults to Nano Banana through router.flatkey.ai because it works well for direct CLI generation. Use --model gpt when you explicitly want the OpenAI-compatible GPT Image 2 endpoint.

Browse templates from terminal:

npx @flatkey-ai/image-buddy list
npx @flatkey-ai/image-buddy show premium-product-hero
npx @flatkey-ai/image-buddy render premium-product-hero --var "产品名称=Image Buddy"

Optional web gallery:

npx @flatkey-ai/image-buddy web --port 5173

Source install before npm release:

npx github:flatkey-ai/awesome-images

Useful options:

npx @flatkey-ai/image-buddy web --port 5173
npx @flatkey-ai/image-buddy web --no-open
npx @flatkey-ai/image-buddy --help

Developer commands:

npm install
npm test
npm run build:catalog
npm run build

User Flow

1. Run npx @flatkey-ai/image-buddy generate or npx @flatkey-ai/image-buddy generate --prompt "...".
2. Find a template by category or keyword.
3. Expand the template and copy the prompt.
4. Replace variables such as {{product_name}}, {{core_benefit}}, or {{brand_color}}.
5. Register a Flatkey API key at <https://flatkey.ai>.
6. Run image-buddy generate to create and save images locally.

Template Structure

All templates live in src/prompts.js.

Add a new template by appending an object:

{
  id: "unique-template-id",
  title: "Template title",
  industry: "ecommerce-retail",
  category: "product",
  badge: "Hero",
  aspectRatio: "16:9",
  model: "gpt-image-2",
  apiUseCase: "Best-fit API use case.",
  description: "Template description.",
  variables: ["product_name", "core_benefit"],
  prompt: "Create a commercial hero image for {{product_name}}..."
}

Use industry for the business context and category for the visual production pattern. Keep the human-facing description separate from the model-facing prompt; details are documented in docs/prompt-format.md.

After adding templates, run:

npm test

The validator checks template count, categories, variables, prompt length, and Flatkey registration links.

Release Publishing

Publishing runs from GitHub Releases.

1. Add an npm automation token to GitHub repository secrets as NPM_PUBLISH_TOKEN.
2. Create a GitHub Release with tag v1.2.3 or 1.2.3.
3. The workflow sets package.json and package-lock.json to that release version.
4. The workflow runs validation, build, and npm publish --access public.

Star History