PiAPI/Ace Step-Text to Audio

Overview

This endpoint from PiAPI's Ace Step API can generate audio based on prompt or reference audio with lyrics.
The lyric placement is highly flexible—PiAPI users can customize lyric integration using structured input formats.

Information&Pricing

$0.0005 per seconds (duration of generated audio)

Example

To generate reasonable audio, Users could choose audio style(e.g., pop) based on text or upload Base64 or url of reference audio.
Here is an example that users could follow when they need to generate a song with lyrics:
[verse]
Sunshine on the boulevard the beach is calling loud
Waves are dancing golden sand under a cotton cloud
Electric heartbeat pounding fast the tide is on our side
Catch a wave and feel alive we’ll take it for a ride

[verse]
Palm trees swaying left to right they know where we belong
Feel the rhythm of the night it keeps us moving strong
Sea spray kisses salty air we’re flying with the breeze
Champagne states of mind we ride we do just as we please

[chorus]
We’re riding waves of life together hand in hand
With every beat we chase the beat it’s our own wonderland
Feel the music take you higher as the shorelines blur
This is our world our endless summer as we live and learn

[bridge]
Moonlight paints the ocean blue reflections in our eyes
Stars align to light our path we’re surfing through the skies
Every moment like a song we sing it loud and clear
Every day’s a new adventure with you always near

[verse]
Neon lights and city sounds they blend with ocean views
We’re unstoppable tonight no way that we can lose
Dreams are written in the sand they sparkle in the sun
Together we’re a masterpiece our story’s just begun

Request

Header Params

x-api-key

string

optional

your api key

Body Params application/json

model

enum<string>

required

Model name, currently select Qubico/ace-step.

Allowed value:

Qubico/ace-step

task_type

enum<string>

required

Currently select txt2audio.

Allowed value:

txt2audio

input

object

required

style_prompt

string

required

Describe the style of audio that you want to generate.

negative_style_prompt

string

optional

Describe the style of audio that you don't want to generate.

lyrics

string

optional

The lyrics of the audio. If not provided, default use [inst] to generate instrument only audio.

duration

integer

optional

The duration of the generated audio

>= 10<= 240

Default:

config

object

optional

webhook_config

object

optional

Example

{
    "model": "Qubico/ace-step",
    "task_type": "txt2audio",
    "input": {
        "style_prompt": "guitar and piano",
        "negative_prompt": "noise",
        "lyrics": "[inst]",
        "duration": 10
    },
    "config": {
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

model

string

optional

task_type

string

optional

input

object

optional

prompt

string

required

negative_prompt

string

optional

video

string

required

steps

integer

optional

seed

integer

optional

config

object

optional

webhook_config

object

optional

Example

{
    "timestamp": 1749613445,
    "data": {
        "task_id": "f8d11a53-f3ac-47ad-a4d6-7610fda830be",
        "model": "Qubico/ace-step",
        "task_type": "txt2audio",
        "status": "completed",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/72bc9c29-2e33-4534-b840-80c86803fd6a",
                "secret": ""
            }
        },
        "input": {
            "duration": 10,
            "lyrics": "[inst]",
            "negative_style_prompt": "",
            "style_audio": "",
            "style_prompt": "guitar and piano"
        },
        "output": {
            "audio_url": "https://img.theapi.app/temp/2c802652-03bb-4266-8d4b-1cd81da45dcb.mp3"
        },
        "meta": {
            "created_at": "2025-06-11T11:43:31.673594+08:00",
            "started_at": "2025-06-11T11:43:32.473551+08:00",
            "ended_at": "2025-06-11T11:44:05.72226+08:00",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 5000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}

Text to Audio

Overview#

Information&Pricing#

Example#

Request

Request samples

Responses

Overview

Information&Pricing

Example