ace-step

Generates music and songs from text prompts via the Pixazo API.

Updated May 2, 2026
One-click install
npx skills add https://github.com/Pixazo-AI/skills --skill ace-step-pixazo-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ace-step
Source: https://github.com/Pixazo-AI/skills/tree/main/skills/ace-step
Command: npx skills add https://github.com/Pixazo-AI/skills --skill ace-step-pixazo-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve? Creating original music, songs, or background tracks normally requires composition skills or licensing stock audio. This Skill lets an AI agent call the Ace Step Music API through the Pixazo gateway to generate custom music from a text prompt, with control over lyrics, duration, BPM, key, and time signature. ## Core Features & Use Cases - Text-to-song generation: Submit a descriptive prompt (genre, mood, instrumentation) and receive a finished audio track via asynchronous task polling. - Parameter control: Set duration, BPM, musical key, time signature, lyrics, and seed for reproducible results across Ace Step 1.5 and Ace Step 1.5 XL endpoints. - Guided API key setup: Walks the agent through acquiring a Pixazo API key once and saving it to ~/.pixazo/api-key, plus structured handling of 401/402/429/5xx errors. - Use Case: A video creator needs a 2-minute cinematic orchestral track in E minor at 140 BPM; the agent submits the request, polls until complete, and returns the audio URL. ## Quick Start Ask the agent to generate a two-minute cinematic orchestral music track with Ace Step and provide your Pixazo API key when prompted.

Frequently Asked Questions about ace-step

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

FAQPage Schema
How do I generate music from a text prompt with an API?▼

Send a POST request to the Ace Step endpoint at gateway.pixazo.ai with a prompt describing genre, mood, and instrumentation, plus optional duration, BPM, key, and lyrics. The API returns a task ID that you poll until the audio URL is ready.

How to make an AI-generated song with custom lyrics?▼

Include your lyrics in the lyrics field of the Ace Step request body alongside the prompt. You can also set BPM, musical key, time signature, and a seed value to control the composition and reproduce results.

What is the difference between Ace Step 1.5 and Ace Step 1.5 XL?▼

Both versions perform text-to-song generation but use different endpoints and operation IDs: ace-step uses generate-music, while ace-step-xl uses getGenerationResult. The full parameter differences are documented at pixazo.ai/models/ace-step.md.

Why is my Pixazo music generation request returning a 401 error?▼

A 401 means the API key is missing or invalid. Check the PIXAZO_API_KEY environment variable or the ~/.pixazo/api-key file, and generate a fresh key at api-console.pixazo.ai/api_keys if needed.

How long does Ace Step music generation take?▼

Generation is asynchronous: the initial request returns a task ID immediately, and you poll the result endpoint every 5-10 seconds. Music tasks typically complete within about three minutes.