Check Music Status (Feed API)

Fetch the status and results of a music generation or extension task.

Endpoint Overview

GET/api/v1/audio/music/feed?workId={workId}

After starting a generation task, use this endpoint to poll for its status.

Generation has 3 stages:

Text Stage: status="text" - Lyrics and metadata generated
First Audio Stage: status="first" - First audio segment generated successfully
Complete Stage: Both audio segments finished

Poll this endpoint every 5-10 seconds until generation completes or fails.

Note: You can also use the generic GET /api/v1/tasks/{task_id} endpoint for polling.

Parameters

Parâmetro	Tipo	Obrigatório	Descrição
`workId`	string	Obrigatório	The unique ID of the generation task, received from a POST /api/v1/audio/music request.

Example Request

cURL

bash

curl -X GET "https://apiin.one/api/v1/audio/music/feed?workId=gen123abc456def789ksv" \
  -H "Authorization: Bearer aio_your_api_key_here"

Example Response

Response when the task is fully completed.

json

{
  "code": 200,
  "message": "success",
  "data": {
    "type": "SUCCESS",
    "request_body": {
      "prompt": "...",
      "title": "Summer Dreams",
      "tags": "pop",
      "make_instrumental": false,
      "model": "suno-v4-5"
    },
    "response_data": [
      {
        "id": "song_abc123",
        "audio_url": "https://audiopipe.suno.ai/?item_id=song_abc123",
        "image_url": "https://cdn2.suno.ai/image_abc123.jpeg",
        "status": "complete",
        "title": "Summer Dreams",
        "duration": 186,
        "model_name": "suno-v4-5",
        "extra_message": "All generated successfully.",
        "fail_message": "",
        "error_message": ""
      },
      {
        "id": "song_def456",
        "audio_url": "https://audiopipe.suno.ai/?item_id=song_def456",
        "image_url": "https://cdn2.suno.ai/image_def456.jpeg",
        "status": "complete",
        "title": "Summer Dreams",
        "duration": 210,
        "model_name": "suno-v4-5",
        "extra_message": "All generated successfully.",
        "fail_message": "",
        "error_message": ""
      }
    ],
    "created_at": "2026-02-24T12:00:31Z"
  }
}

Error Handling

Status Code	Tipo	Obrigatório	Descrição
`404`	not_found	Opcional	Task not found or expired.
`401`	authentication_error	Opcional	Invalid or missing API key.