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.