acestep-thumbnail

Generate song cover and thumbnail images via the Gemini API.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Leon102938/HyperLTX-2 --skill acestep-thumbnail-leon102938
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: acestep-thumbnail
Source: https://github.com/Leon102938/HyperLTX-2/tree/main/ACE-Step-1.5/.claude/skills/acestep-thumbnail
Command: npx skills add https://github.com/Leon102938/HyperLTX-2 --skill acestep-thumbnail-leon102938

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Music creators often need visually compelling thumbnails and MV backgrounds but lack a quick, automated way to generate consistent, high-quality imagery tailored to their songs.

Core Features & Use Cases

  • Automated generation of song cover art and thumbnails via Gemini image-generation.
  • Supports configurable aspect ratios suitable for album art (1:1) or MV backgrounds (16:9) and easy saving to disk.
  • Use Case: quickly produce multiple thumbnail options for a new single and choose the best fit for streaming platforms.

Quick Start

Configure your Gemini API key and run the generate command with a prompt to create a music thumbnail.

Frequently Asked Questions about acestep-thumbnail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate album art and MV backgrounds using an AI image generation API?▼

To generate album art and MV backgrounds, you can use an AI image generation API like Gemini. You provide a text prompt and configure the aspect ratio to produce high-quality music thumbnails saved directly to disk.

Can I generate music thumbnails in specific aspect ratios like 1:1 or 16:9?▼

Yes, you can generate music thumbnails in specific aspect ratios like 1:1 or 16:9. The generation process supports configurable aspect ratios suitable for standard album art or wider MV backgrounds.

Do I need a Gemini API key to automate song cover creation?▼

Yes, you need a Gemini API key to automate song cover creation. Configuring your API key is a required prerequisite to authenticate requests and generate visual content through the Gemini image-generation service.

What is the best way to create multiple thumbnail options for a new single?▼

The best way to create multiple thumbnail options for a new single is by running a prompt-based AI image generation process multiple times. This allows you to quickly produce varied visual content and choose the best fit for streaming platforms.

How does prompt-based image generation work for music thumbnails?▼

Prompt-based image generation for music thumbnails works by accepting a descriptive text prompt and using an AI model to create matching imagery. The resulting image is then saved to a default or specified file path on disk.

Are there limitations when using AI to automate visual content creation for music?▼

Limitations when using AI to automate visual content creation include relying entirely on the Gemini API's capabilities and your prompt specificity. You need a valid API key and must manually configure aspect ratios to match your target streaming platform.