## Basic tool info Tool name: ACE-Step/text-to-song-ACE-Step-v1-3.5B Tool description: Generate high-quality songs from text prompts in seconds. Whether you're crafting instrumental tracks or full vocal compositions, bring your musical ideas to life with the power of AI. Ideal for artists, producers, and creative minds looking to turn inspiration into sound. Tool cover: https://cdn.wiro.ai/uploads/models/ACE-Step-text-to-song-ACE-Step-v1-3.5B-cover.jpg Tool categories: - tool - text-to-song - persistent - quick-showcase - use-agent Tool tags: - text-to-audio - music - text2music - apache-2.0 Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/ACE-Step/text-to-song-ACE-Step-v1-3.5B Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: The lyrics to generate the song. type: textarea default: [verse] Bright lights flashing in the city sky Running fast and we don't know why Electric nights got our hearts on fire Chasing dreams we'll never tire [verse] Grit in our eyes wind in our hair Breaking rules we don't even care Shouting loud above the crowd Living life like we're unbowed [chorus] Running wild in the night so free Feel the beat pumping endlessly Hearts collide in the midnight air We belong we don't have a care [verse] Piercing through like a lightning strike Every moment feels like a hike Daring bold never backing down Kings and queens without a crown [chorus] Running wild in the night so free Feel the beat pumping endlessly Hearts collide in the midnight air We belong we don't have a care [bridge] Close your eyes let your spirit soar We are the ones who wanted more Breaking chains of the mundane In this world we'll make our claim - name: genre label: genre help: type: multiselect default: Pop options: - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - name: instrument label: instrument help: type: multiselect default: guitar options: - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - name: mood label: mood help: type: multiselect default: happy options: - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - name: gender label: gender help: type: multiselect default: female options: - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - name: timbre label: timbre help: type: multiselect default: bright vocal options: - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - value: "undefined" label: undefined - name: audioDuration label: Duration help: Total duration of the generated audio (in seconds) type: number default: 60 - name: seed label: seed help: seed-help type: text default: 42 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 60 - name: scale label: guidancescale help: guidancescale-help type: float default: 15 - name: scheduler label: scheduler help: Scheduler type type: select default: euler options: - value: "euler" label: euler - value: "heun" label: heun - name: cfg label: Guidance Type help: Guidance scale for CFG type: select default: apg options: - value: "apg" label: apg - value: "cfg" label: cfg - value: "cfg_star" label: cfg_star - name: omegaScale label: Granularity Scale help: Omega scale for CFG types type: number default: 10 - name: guidanceInterval label: Guidance Interval help: Guidance interval type: float default: 0.5 - name: guidanceIntervalDecay label: Guidance Interval Decay help: Guidance interval decay type: float default: 0 - name: minGuidanceScale label: Min Guidance Scale help: Minimum guidance scale type: float default: 3 - name: guidanceScaleText label: Text Guidance Scale help: Guidance scale for tags type: float default: 0 - name: guidanceScaleLyric label: Lyric Guidance Scale help: Guidance scale for lyrics type: float default: 0 ## Tool Parameter Inspires: - prompt: [verse] Empty streets, walking all alone Echoes of your voice inside my phone Late night thoughts keep pulling me in I wonder if you feel the way I did [chorus] I’m lost without you, can’t you see? The pieces don’t fit without you next to me Every step I take just leads me back to you I’m lost without you, what am I gonna do? [verse] Pictures fade but memories stay I’m haunted by the words I didn’t say You were the calm inside my storm Now I’m here just trying to stay warm [bridge] If you feel alone tonight Know I’m still holding tight Waiting for a sign from you [outro] I’m lost without you, I’m lost without you - prompt: [verse] Staring at the sunset, colors paint the sky Thoughts of you keep swirling, can't deny I know I let you down, I made mistakes But I'm here to mend the heart I didn't break [chorus] Every road you take, I'll be one step behind Every dream you chase, I'm reaching for the light You can't fight this feeling now I won't back down You know you can't deny it now I won't back down [verse] They might say I'm foolish, chasing after you But they don't feel this love the way we do My heart beats only for you, can't you see? I won't let you slip away from me [bridge] No, I won't back down, won't turn around Until you're back where you belong I'll cross the oceans wide, stand by your side Together we are strong [outro] Every road you take, I'll be one step behind Every dream you chase, love's the tie that binds You can't fight this feeling now I won't back down - prompt: [verse] Woke up feeling stronger than before I’ve been through battles, scars and more This heart don’t break, it only learns Watch me rise, feel the fire burn [chorus] I’ve got fire in my veins Can’t hold me down, can’t feel the chains Every word, every fight, feeds the flame I’ve got fire in my veins [verse] Doubt me now, you’ll see me fly Failure’s just fuel that keeps me alive Lightning strikes but I won’t fall I’m standing here, I’m standing tall [bridge] This is my time, this is my fight Burning brighter in the night [outro] Fire in my veins, fire in my soul You can’t stop what you can’t control - prompt: [verse] Neon lights blur the city view I’m lost in thought, dreaming of you Every song plays like you’re near Your voice still lingers in my ear [chorus] I wanna fade into you Let this world disappear too Every second feels brand new When I fade into you [verse] Time slows down when you’re in my mind All the noise just leaves me behind Floating through this midnight blue All I want is to be with you [bridge] Colors melt, shadows break Hearts collide, we can’t fake [outro] Fade into you… fade into you - prompt: [verse] We’ve been through storms, we’ve lost our way But I still feel you every day Broken roads and nights alone Led me right back to our home [chorus] I’ll never let go, never lose sight You’re the reason I still fight Every mile, every dream I know I’ll never let go [verse] Doubt may whisper, fear may call But love will catch us when we fall Hands held tight, we’ll find a way I’m here forever, I’ll stay [bridge] We’re stronger now than yesterday Nothing’s gonna pull us away [outro] Never let go, never let go - prompt: [verse] Empty rooms still call your name Old love songs don’t feel the same Shadows move like memories do Every echo brings me back to you [chorus] In the echoes of us, I still believe Love doesn’t die, it never leaves Every whisper, every trace Brings me back to your embrace [verse] City lights fade out too soon But I still see your face in the moon Time can’t erase what we had I feel you here, good or bad [bridge] Even if the world falls apart You’re forever in my heart [outro] In the echoes of us… echoes of us ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/ACE-Step/text-to-song-ACE-Step-v1-3.5B" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "[verse]\nBright lights flashing in the city sky\nRunning fast and we don't know why\nElectric nights got our hearts on fire\nChasing dreams we'll never tire\n\n[verse]\nGrit in our eyes wind in our hair\nBreaking rules we don't even care\nShouting loud above the crowd\nLiving life like we're unbowed\n\n[chorus]\nRunning wild in the night so free\nFeel the beat pumping endlessly\nHearts collide in the midnight air\nWe belong we don't have a care\n\n[verse]\nPiercing through like a lightning strike\nEvery moment feels like a hike\nDaring bold never backing down\nKings and queens without a crown\n\n[chorus]\nRunning wild in the night so free\nFeel the beat pumping endlessly\nHearts collide in the midnight air\nWe belong we don't have a care\n\n[bridge]\nClose your eyes let your spirit soar\nWe are the ones who wanted more\nBreaking chains of the mundane\nIn this world we'll make our claim", "genre": [ "Pop" ], "instrument": [ "guitar" ], "mood": [ "happy" ], "gender": [ "female" ], "timbre": [ "bright vocal" ], "audioDuration": 60, "seed": "42", "steps": 60, "scale": "15", "scheduler": "euler", "cfg": "apg", "omegaScale": 10, "guidanceInterval": "0.5", "guidanceIntervalDecay": "0", "minGuidanceScale": "3", "guidanceScaleText": "0", "guidanceScaleLyric": "0", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": 'eDcCm5yyUfIvMFspTwww49OUfgXkQt', }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.