Home
API Reference

Query Task

get
https://api.topview.ai/v1/common_task/ai_music/task/query

Query the status and output of an AI music generation task by taskId. outputs is empty while the task is in progress; on success, returns the generated audio fileId and access URL.

Status: Unfinished tasks are always returned as running; finished tasks return success or fail.

Credits: costCredit is the actual credit consumed; updated after task success.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
Defaults to 6f4b5a8c9d0e1f2a3b4c5d6

Task ID returned from the submit API

boolean
Defaults to false

When true, outputs[].url prefers CloudFront CDN URLs; default false returns S3 URLs

Headers
string
required
Defaults to uid

User ID; must match the task owner

string
required
Defaults to Bearer apiKey

API key for authentication. Format: Bearer {apiKey}

Response

Updated 1 day ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 1 day ago