Qubico
  1. Create Task
Qubico
  • Get Started
    • Overview
    • Quickstart
  • Endpoints
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Kontext
        • Text to Image
        • Image to Image
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • WanX
      • Generate WanX Task with LoRA Using Qubico
      • Available LoRA Types for Wanx
      • Use Cases for Wanx LoRA
      • Use Cases for Wanx Control Camera
      • Create Task
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
      • Get Task
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Ace Step
      • Create Task
        • Text to Audio
          POST
        • Audio to Audio
          POST
        • Audio Edit
          POST
        • Audio Extend
          POST
      • Get Task
        GET
    • Tools
      • File Upload API
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
    • Account Management
      • Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Billings
  1. Create Task

Audio to Audio

POST
/api/v1/task

Overview#

This endpoint from Qubico's Ace Step API can generate audio based on a text prompt and/or reference audio with lyrics.
Lyric placement is highly flexible—Qubico users can customize lyric timing using structured input formats.

Information & Pricing#

$0.0005 per second (based on the duration of the generated audio)

Example#

To generate high-quality audio, users can:
Choose an audio style (e.g., pop, electronic)
Provide a text prompt and/or a reference audio (via Base64 or URL)
Optionally use timestamped lyrics for precise vocal placement
Here is an example of structured lyrics for a generated song:
[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
[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
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "Qubico/ace-step",
    "task_type": "audio2audio",
    "input": {
        "style_audio": "https://img.theapi.app/temp/2c802652-03bb-4266-8d4b-1cd81da45dcb.mp3",
        "style_prompt": "rock",
        "negative_prompt": "noise",
        "lyrics": "[inst]"
    },
    "config": {
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}'
Response Response Example
{
    "timestamp": 1749614943,
    "data": {
        "task_id": "352fa52e-02ca-4dd1-a6f3-ee985f648d65",
        "model": "Qubico/ace-step",
        "task_type": "audio2audio",
        "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": "https://img.theapi.app/temp/2c802652-03bb-4266-8d4b-1cd81da45dcb.mp3",
            "style_prompt": "rock"
        },
        "output": {
            "audio_url": "https://img.theapi.app/temp/d4f4c2a7-c5d1-4bb1-8445-248a23f3522b.mp3"
        },
        "meta": {
            "created_at": "2025-06-11T12:08:26.781691+08:00",
            "started_at": "2025-06-11T12:08:30.393373+08:00",
            "ended_at": "2025-06-11T12:09:03.411024+08:00",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 0
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Modified at 2025-07-06 07:51:26
Previous
Text to Audio
Next
Audio Edit
Built with