v1

latestOpenAPI 3.0.02026-07-26117076.0 KB

Music Generation

Query Music Generation Detail

Retrieve detailed results and status of a music generation task

get/api/generate/detail/music

Query parameters

task_idstring required

Unique task identifier returned from the music generation submission endpoint.

Response

Task detail retrieved successfully

codeinteger required

HTTP status code

Example response

{
  "code": 200,
  "data": {
    "task_id": "8FDN1I7M7Q68DDG8",
    "status": "finished",
    "credits_amount": 10,
    "files": [
      {
        "audio_id": "62e4542a-73be-44e1-b397-7716ee7505c6",
        "audio_url": "https://storage.poyo.ai/audio/8FDN1I7M7Q68DDG8/20251125113627_QIivN2_tmphb8rgpeb_audio_62e4542a-73be-44e1-b397-7716ee7505c6.mp3",
        "image_url": "https://storage.poyo.ai/audio/8FDN1I7M7Q68DDG8/20251125113628_4DfWp6_tmpz72j05o5_cover_62e4542a-73be-44e1-b397-7716ee7505c6.jpeg",
        "title": "Peaceful Piano Meditation",
        "tags": "Classical",
        "duration": 240,
        "prompt": "City pop, 80s retro, groovy synth bass",
        "text": "Peaceful Piano Meditation lyrics content...",
        "timestampe_lyrics": "[00:00.00] First line of lyrics\n[00:05.23] Second line of lyrics",
        "style": "Enhanced music style result",
        "wav_url": "https://storage.poyo.ai/audio/8FDN1I7M7Q68DDG8/output.wav",
        "separate_vocals": "{\"vocal_url\": \"xx\", \"instrumental_url\": \"yy\"}",
        "vocal_removal": "{\"bass\": \"https://storage.poyo.ai/audio/bass.mp3\", \"drums\": \"https://storage.poyo.ai/audio/drums.mp3\"}",
        "stem_split": "{\"backing_vocals_url\": \"\", \"bass_url\": \"\"}",
        "generate_cover": "[{\"file_url\": \"https://storage.poyo.ai/audio/cover_1.png\", \"file_type\": \"image\"}]",
        "persona_id": "persona_abc123",
        "video_url": "https://storage.poyo.ai/video/8FDN1I7M7Q68DDG8/music_video.mp4"
      }
    ],
    "created_time": "2025-11-25T08:50:13"
  }
}