Query Music Generation Detail
curl --request GET \
--url https://api.vidgo.ai/api/generate/detail/music \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.vidgo.ai/api/generate/detail/music"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vidgo.ai/api/generate/detail/music', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vidgo.ai/api/generate/detail/music",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vidgo.ai/api/generate/detail/music"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.vidgo.ai/api/generate/detail/music")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vidgo.ai/api/generate/detail/music")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "8FDN1I7M7Q68DDG8",
"status": "finished",
"files": [
{
"audio_id": "62e4542a-73be-44e1-b397-7716ee7505c6",
"audio_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113627_QIivN2_tmphb8rgpeb_audio_62e4542a-73be-44e1-b397-7716ee7505c6.mp3",
"image_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113628_4DfWp6_tmpz72j05o5_cover_62e4542a-73be-44e1-b397-7716ee7505c6.jpeg",
"title": "Peaceful Piano Meditation",
"tags": "Classical",
"duration": 240,
"prompt": ""
},
{
"audio_id": "8e755734-a840-4c13-beac-b9f1044979ca",
"audio_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113630_x7VTpV_tmpvsijwxa6_audio_8e755734-a840-4c13-beac-b9f1044979ca.mp3",
"image_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113631_3MTe5V_tmp98wzcx2m_cover_8e755734-a840-4c13-beac-b9f1044979ca.jpeg",
"title": "Peaceful Piano Meditation",
"tags": "Classical",
"duration": 130,
"prompt": ""
}
],
"created_time": "2025-11-25T08:50:13",
"error_message": null
}
}Suno AI
Query Music Detail
Query detailed results of music generation tasks
GET
/
api
/
generate
/
detail
/
music
Query Music Generation Detail
curl --request GET \
--url https://api.vidgo.ai/api/generate/detail/music \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.vidgo.ai/api/generate/detail/music"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vidgo.ai/api/generate/detail/music', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vidgo.ai/api/generate/detail/music",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vidgo.ai/api/generate/detail/music"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.vidgo.ai/api/generate/detail/music")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vidgo.ai/api/generate/detail/music")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "8FDN1I7M7Q68DDG8",
"status": "finished",
"files": [
{
"audio_id": "62e4542a-73be-44e1-b397-7716ee7505c6",
"audio_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113627_QIivN2_tmphb8rgpeb_audio_62e4542a-73be-44e1-b397-7716ee7505c6.mp3",
"image_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113628_4DfWp6_tmpz72j05o5_cover_62e4542a-73be-44e1-b397-7716ee7505c6.jpeg",
"title": "Peaceful Piano Meditation",
"tags": "Classical",
"duration": 240,
"prompt": ""
},
{
"audio_id": "8e755734-a840-4c13-beac-b9f1044979ca",
"audio_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113630_x7VTpV_tmpvsijwxa6_audio_8e755734-a840-4c13-beac-b9f1044979ca.mp3",
"image_url": "https://file.goseaapp.com/audio/8FDN1I7M7Q68DDG8/20251125113631_3MTe5V_tmp98wzcx2m_cover_8e755734-a840-4c13-beac-b9f1044979ca.jpeg",
"title": "Peaceful Piano Meditation",
"tags": "Classical",
"duration": 130,
"prompt": ""
}
],
"created_time": "2025-11-25T08:50:13",
"error_message": null
}
}Usage Guide
- All POST submission requests in the Music Series can query their results through this endpoint. Different models will return different response fields.
Parameter Details
task_id(required): The unique task identifier returned from the music generation submission endpoint
Usage Notes
- Poll this endpoint to check task completion status
- The
filesarray will be empty until the task status isfinished - When a task fails, check the
error_messagefield for details - Multiple audio files may be returned for a single task as variations are generated
Response Fields (files data)
Thefiles array content varies depending on which model created the task.
| Model | Field | Type | Description |
|---|---|---|---|
generate-music, extend-music, upload-and-cover-audio, upload-and-extend-audio, add-instrumental, add-vocals, replace-section | audio_id | string | Unique identifier for the audio file |
| ↑ | audio_url | string | Direct download URL for the audio file |
| ↑ | image_url | string | Cover image URL |
| ↑ | title | string | Track title |
| ↑ | tags | string | Style tags |
| ↑ | duration | number | Audio duration in seconds |
| ↑ | prompt | string | Generation prompt used |
get-timestamped-lyrics | timestampe_lyrics | string | Lyrics with timestamps |
generate-lyrics | title | string | Lyrics title |
| ↑ | text | string | Complete lyrics content |
boost-music-style | style | string | Enhanced music style |
convert-to-wav | wav_url | string | URL to converted WAV file |
separate-vocals | separate_vocals | string (JSON) | JSON string containing separated audio URLs. See details |
upload-and-separate-vocals | vocal_removal | string (JSON) | JSON string containing separated stem URLs. See details |
stem-split | stem_split | string (JSON) | JSON string containing full stem separation URLs. See details |
generate-music-cover | generate_cover | string (JSON) | JSON string containing generated cover images. See details |
generate-persona | persona_id | string | Generated persona identifier |
create-music-video | video_url | string | Generated video URL |
JSON Field Details
separate-vocals
separate_vocals fields:
vocal_url- URL to the extracted vocal trackinstrumental_url- URL to the instrumental track
upload-and-separate-vocals
vocal_removal fields:
bass- URL to the bass trackdrums- URL to the drums trackpiano- URL to the piano trackguitar- URL to the guitar trackvocals- URL to the vocals trackother- URL to other audio elements
stem-split
stem_split fields:
backing_vocals_url- URL to backing vocalsbass_url- URL to bass trackbrass_url- URL to brass instrumentsdrums_url- URL to drums trackfx_url- URL to sound effectsguitar_url- URL to guitar trackkeyboard_url- URL to keyboard trackpercussion_url- URL to percussion trackstrings_url- URL to strings tracksynth_url- URL to synthesizer trackvocal_url- URL to main vocalswoodwinds_url- URL to woodwinds track
generate-music-cover
generate_cover is a JSON array containing cover image objects:
file_url- URL to the generated cover imagefile_type- File type (e.g., “image”)
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer VIDGO_API_KEY
Query Parameters
Unique task identifier returned from the music generation submission endpoint.