Hunt Townh402
Catalog
AIPOSTlive

Music generation status (async)

Poll a Suno music-generation job by job id; returns the audio URLs once ready. Companion to ai/music-generate-async.

$0.005
per call
Success
100%
p50 latency
1.74s
p95 latency
2.92s
Calls (30d)
2
Flow①Music generation (async)→ ② Music generation status (async) (this step)— run step ① first; its response carries the input for this step.

Provider contract

Call path
/routes/locus-suno/ai/music-generate-async-status
Method
POST
Selected provider
locus-sunodefault
Provider price
$0.005
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/locus-suno/ai/music-generate-async-status' \
  -H 'content-type: application/json' \
  -d '{"taskId":"636dada7dfba083eb3b9855e666ff979"}'
CLI
h402 call 'ai/music-generate-async-status' --provider 'locus-suno' --method POST --json '{"taskId":"636dada7dfba083eb3b9855e666ff979"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

taskIdstringrequired

Job id returned by ai/music-generate-async (Suno task id).

e.g.
POST/routes/locus-suno/ai/music-generate-async-status
Request body
{
  "taskId": "636dada7dfba083eb3b9855e666ff979"
}

ResponseExample response
{
  "data": {
    "success": true,
    "data": {
      "code": 200,
      "msg": "success",
      "data": {
        "taskId": "636dada7dfba083eb3b9855e666ff979",
        "parentMusicId": "",
        "param": "{\"callBackUrl\":\"https://noop.paywithlocus.com/suno\",\"customMode\":false,\"instrumental\":false,\"model\":\"V4_5\",\"prompt\":\"An upbeat indie-pop song about a sunrise road trip with friends\"}",
        "response": {
          "taskId": "636dada7dfba083eb3b9855e666ff979",
          "sunoData": [
            {
              "id": "ea9974d1-17c0-448f-abc5-b189c9ee5da4",
              "audioUrl": "https://tempfile.aiquickdraw.com/r/4596096e6c334732b5d84ca584f39dbe.mp3",
              "sourceAudioUrl": "https://cdn1.suno.ai/ea9974d1-17c0-448f-abc5-b189c9ee5da4.mp3",
              "streamAudioUrl": "https://musicfile.removeai.ai/ZWE5OTc0ZDEtMTdjMC00NDhmLWFiYzUtYjE4OWM5ZWU1ZGE0",
              "sourceStreamAudioUrl": "https://cdn1.suno.ai/ea9974d1-17c0-448f-abc5-b189c9ee5da4.mp3",
              "imageUrl": "https://musicfile.removeai.ai/ZWE5OTc0ZDEtMTdjMC00NDhmLWFiYzUtYjE4OWM5ZWU1ZGE0.jpeg",
              "sourceImageUrl": "https://cdn2.suno.ai/image_ea9974d1-17c0-448f-abc5-b189c9ee5da4.jpeg",
              "prompt": "[Verse 1]\nKeys in the bowl\nShoes by the door\nYou said, \"Let’s go\"\nI said, \"One minute more\"\n\nPack the backseat\nSoda cans and maps\nYour laugh in the rearview\nMessed up my plans\n\n[Pre-Chorus]\nNow the sky turns pink\nOver those grainy hills\nWe’re half-awake\nBut the whole world stills\n\n[Chorus]\nTake me there, take me there\nOn that sunrise road\nTake me there, take me there\nWith the windows rolled\nWe got young hearts, full tanks\nAnd a day to spend\nTake me there, take me there\nAgain, again, again (again, again)\n\n[Verse 2]\nGas station coffee\nPaper cup in hand\nYou bought hot chips\nAt the last truck stand\n\nSomeone in the back\nStarted up that song\nWe all sang wrong\nBut we sang along\n\n[Pre-Chorus]\nNow the sky turns gold\nOn the dashboard dash\nEvery mile we missed\nComes back fast\n\n[Chorus]\nTake me there, take me there\nOn that sunrise road\nTake me there, take me there\nWith the windows rolled\nWe got young hearts, full tanks\nAnd a day to spend\nTake me there, take me there\nAgain, again, again (again, again)\n\n[Bridge]\nIf Monday waits\nIt can wait behind\nWe’re a little lost\nIn the best kind\n\nYour hand on the wheel\nMy feet on the seat\nNothing ahead\nThat we gotta beat\n\n[Chorus]\nTake me there, take me there\nOn that sunrise road\nTake me there, take me there\nWith the windows rolled\nWe got young hearts, full tanks\nAnd a day to spend\nTake me there, take me there\nAgain, again, again (again, again)",
              "modelName": "chirp-auk",
              "title": "Highway Peach",
              "tags": "Indie-pop with buoyant mid-tempo four-on-the-floor, clapping backbeat, chiming guitars, rubbery bass, and hand percussion; verse rides tight drum kit and sunlit acoustic plucks, pre-chorus lifts with stacked harmonies and a filtered synth swell, chorus opens wide with gang vocals and brighter keys. Vocal is close-mic and playful with double-tracked hooks, little ad-lib tags, and delay throws on the last word. Add wind-down risers, tire-on-gravel foley, and a brief reverse-guitar pull between sections. Bright, punchy, and glossy but human., pop",
              "createTime": 1782461129725,
              "duration": 173.48
            },
            {
              "id": "526643f1-e9da-4727-9e84-a717b55f1db6",
              "audioUrl": "https://tempfile.aiquickdraw.com/r/f8e67ce4babb42c2aba6791e4f1ae37d.mp3",
              "sourceAudioUrl": "https://cdn1.suno.ai/526643f1-e9da-4727-9e84-a717b55f1db6.mp3",
              "streamAudioUrl": "https://musicfile.removeai.ai/NTI2NjQzZjEtZTlkYS00NzI3LTllODQtYTcxN2I1NWYxZGI2",
              "sourceStreamAudioUrl": "https://cdn1.suno.ai/526643f1-e9da-4727-9e84-a717b55f1db6.mp3",
              "imageUrl": "https://musicfile.removeai.ai/NTI2NjQzZjEtZTlkYS00NzI3LTllODQtYTcxN2I1NWYxZGI2.jpeg",
              "sourceImageUrl": "https://cdn2.suno.ai/image_526643f1-e9da-4727-9e84-a717b55f1db6.jpeg",
              "prompt": "[Verse 1]\nKeys in the bowl\nShoes by the door\nYou said, \"Let’s go\"\nI said, \"One minute more\"\n\nPack the backseat\nSoda cans and maps\nYour laugh in the rearview\nMessed up my plans\n\n[Pre-Chorus]\nNow the sky turns pink\nOver those grainy hills\nWe’re half-awake\nBut the whole world stills\n\n[Chorus]\nTake me there, take me there\nOn that sunrise road\nTake me there, take me there\nWith the windows rolled\nWe got young hearts, full tanks\nAnd a day to spend\nTake me there, take me there\nAgain, again, again (again, again)\n\n[Verse 2]\nGas station coffee\nPaper cup in hand\nYou bought hot chips\nAt the last truck stand\n\nSomeone in the back\nStarted up that song\nWe all sang wrong\nBut we sang along\n\n[Pre-Chorus]\nNow the sky turns gold\nOn the dashboard dash\nEvery mile we missed\nComes back fast\n\n[Chorus]\nTake me there, take me there\nOn that sunrise road\nTake me there, take me there\nWith the windows rolled\nWe got young hearts, full tanks\nAnd a day to spend\nTake me there, take me there\nAgain, again, again (again, again)\n\n[Bridge]\nIf Monday waits\nIt can wait behind\nWe’re a little lost\nIn the best kind\n\nYour hand on the wheel\nMy feet on the seat\nNothing ahead\nThat we gotta beat\n\n[Chorus]\nTake me there, take me there\nOn that sunrise road\nTake me there, take me there\nWith the windows rolled\nWe got young hearts, full tanks\nAnd a day to spend\nTake me there, take me there\nAgain, again, again (again, again)",
              "modelName": "chirp-auk",
              "title": "Highway Peach",
              "tags": "Indie-pop with buoyant mid-tempo four-on-the-floor, clapping backbeat, chiming guitars, rubbery bass, and hand percussion; verse rides tight drum kit and sunlit acoustic plucks, pre-chorus lifts with stacked harmonies and a filtered synth swell, chorus opens wide with gang vocals and brighter keys. Vocal is close-mic and playful with double-tracked hooks, little ad-lib tags, and delay throws on the last word. Add wind-down risers, tire-on-gravel foley, and a brief reverse-guitar pull between sections. Bright, punchy, and glossy but human., pop",
              "createTime": 1782461129725,
              "duration": 164.44
            }
          ]
        },
        "status": "SUCCESS",
        "type": "chirp-auk",
        "operationType": "generate",
        "errorCode": null,
        "errorMessage": null,
        "createTime": 1782461074000
      }
    }
  },
  "h402": {
    "routeId": "ai/music-generate-async-status",
    "provider": "locus-suno",
    "selectedCandidateId": "ai/music-generate-async-status/locus-suno",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}
Last successful call: 25d ago· Aggregated by h402 — not the source provider