GoAPI Ace Step API Documentation

Overview

GoAPI's Ace Step service provides music generation capabilities using advanced AI technology. This endpoint can create audio tracks based on either text prompts or reference audio, complete with synchronized lyrics. The lyric integration is highly customizable - GoAPI users can precisely control lyric placement through structured input formats.

Pricing

$0.0005 per seconds (duration of generated audio)

Model Information

Currently supported model:

Model Name: Qubico/ace-step

Capabilities: Generate audio based on text or reference audio style with lyrics.

Request

Header Params

Body Params application/json

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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful response

Body

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": [
            "no lyrics provided, use [inst] as default"
        ],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}

Text to Audio

GoAPI Ace Step API Documentation#

Overview#

Pricing#