get task / poll result

GET

https://api.aimusicapi.ai/api/v1/producer/task/{task_id}

Poll the status and result of any Producer task — create_music, make_lyrics, video_clip, upload, or download. The response shape inside data[] varies by task type (see examples below).

Cost: Free.

Polling cadence: Every 5–10 seconds is recommended. Tasks normally complete in 30–120 seconds. Continue polling while status is PENDING or RUNNING.

On failure (status: "FAILED"): Credits charged at submit time are automatically refunded. The response message indicates whether the refund has been processed.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.aimusicapi.ai/api/v1/producer/task/6d7253ac-916e-49a8-b288-91ffa7f8a8cd' \
--header 'Authorization: Bearer <token>'

Responses

🟢200

application/json

Task lookup succeeded. status indicates the task's lifecycle state; data[] contains the result(s) when status is SUCCESS.

Body

Examples

Task still running — keep pollingcreate_music task completedmake_lyrics task completed (started by /lyrics-create)video_clip task completed (started by /video-clip)upload task completed (started by /upload)download task completed (started by /download)Task failed — credits auto-refunded

{
    "code": 200,
    "status": "RUNNING",
    "message": "task is still processing",
    "data": []
}

🟠401

🟠404

Modified at 2026-04-27 17:09:53

download

Nuro Instruction