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?utm_source=skill

• 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.

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.

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 https://console.flatkey.ai/keys. The CLI reads the saved key, FLATKEY_IMAGE_API_KEY, or FLATKEY_API_KEY.

• 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.

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

Each template includes:

• 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

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	Skincare Product	UGC Coffee Ad	Fitness App

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

Food	Travel	Portrait	Real Estate
Dessert Hero	Travel Map	Cyber Portrait	Interior Render

Entertainment	Education	Finance	Beauty
Music Cover	Education Card	Finance Dashboard	Beauty Makeup

Architecture	Pet	Sports	Publishing
Architecture Model	Pet Brand	Sports Shoe	Book Cover

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 https://console.flatkey.ai/keys. 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

1. Run npx @flatkey-ai/image-buddy generate <template-id> 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?utm_source=skill.
6. Run image-buddy generate to create and save images locally.

All templates live in src/prompts.js.

Add a new template by appending an object:

{
  id: "unique-template-id",
  title: "Template title",
  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}}..."
}

After adding templates, run:

npm test

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

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.