Fetch Video Job
curl --request GET \
--url https://api.ttapi.io/suno/v2/fetch \
--header 'TT-API-KEY: <api-key>'import requests
url = "https://api.ttapi.io/suno/v2/fetch"
headers = {"TT-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'TT-API-KEY': '<api-key>'}};
fetch('https://api.ttapi.io/suno/v2/fetch', 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.ttapi.io/suno/v2/fetch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"TT-API-KEY: <api-key>"
],
]);
$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.ttapi.io/suno/v2/fetch"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("TT-API-KEY", "<api-key>")
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.ttapi.io/suno/v2/fetch")
.header("TT-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ttapi.io/suno/v2/fetch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["TT-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"message": "success",
"jobId": "video-9c64b7e1-f00d-456e-8c56-a0227f5128fb",
"data": {
"quota": "75.00000000",
"request_body": {
"prompt": "A paper lantern slowly rises into the starry sky as the camera follows it upward.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "9:16"
},
"videos": [
{
"creation_id": "crt_0187b131-a1c0-7151-a92e-cd8645e4bb01",
"status": "succeeded",
"video_url": "https://cdn.ttapi.io/suno/example-1.mp4",
"asset": {
"poster_url": "https://example.com/poster-1.jpg",
"thumbnail_url": "https://example.com/thumbnail-1.jpg",
"last_frame_url": "https://example.com/last-frame-1.jpg",
"width": 480,
"height": 854,
"duration_s": 5.167,
"content_type": "video/mp4",
"status": "ready"
},
"error": null,
"error_code": null
},
{
"creation_id": "crt_0187b131-a1c0-7151-a92e-cd8645e4bb02",
"status": "succeeded",
"video_url": "https://cdn.ttapi.io/suno/example-2.mp4",
"asset": {
"poster_url": "https://example.com/poster-2.jpg",
"thumbnail_url": "https://example.com/thumbnail-2.jpg",
"last_frame_url": "https://example.com/last-frame-2.jpg",
"width": 480,
"height": 854,
"duration_s": 5.167,
"content_type": "video/mp4",
"status": "ready"
},
"error": null,
"error_code": null
}
]
}
}Suno
Suno Video Job Result API
Query Suno video job status and retrieve generated results and failure details.
GET
/
suno
/
v2
/
fetch
Fetch Video Job
curl --request GET \
--url https://api.ttapi.io/suno/v2/fetch \
--header 'TT-API-KEY: <api-key>'import requests
url = "https://api.ttapi.io/suno/v2/fetch"
headers = {"TT-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'TT-API-KEY': '<api-key>'}};
fetch('https://api.ttapi.io/suno/v2/fetch', 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.ttapi.io/suno/v2/fetch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"TT-API-KEY: <api-key>"
],
]);
$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.ttapi.io/suno/v2/fetch"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("TT-API-KEY", "<api-key>")
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.ttapi.io/suno/v2/fetch")
.header("TT-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ttapi.io/suno/v2/fetch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["TT-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "SUCCESS",
"message": "success",
"jobId": "video-9c64b7e1-f00d-456e-8c56-a0227f5128fb",
"data": {
"quota": "75.00000000",
"request_body": {
"prompt": "A paper lantern slowly rises into the starry sky as the camera follows it upward.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "9:16"
},
"videos": [
{
"creation_id": "crt_0187b131-a1c0-7151-a92e-cd8645e4bb01",
"status": "succeeded",
"video_url": "https://cdn.ttapi.io/suno/example-1.mp4",
"asset": {
"poster_url": "https://example.com/poster-1.jpg",
"thumbnail_url": "https://example.com/thumbnail-1.jpg",
"last_frame_url": "https://example.com/last-frame-1.jpg",
"width": 480,
"height": 854,
"duration_s": 5.167,
"content_type": "video/mp4",
"status": "ready"
},
"error": null,
"error_code": null
},
{
"creation_id": "crt_0187b131-a1c0-7151-a92e-cd8645e4bb02",
"status": "succeeded",
"video_url": "https://cdn.ttapi.io/suno/example-2.mp4",
"asset": {
"poster_url": "https://example.com/poster-2.jpg",
"thumbnail_url": "https://example.com/thumbnail-2.jpg",
"last_frame_url": "https://example.com/last-frame-2.jpg",
"width": 480,
"height": 854,
"duration_s": 5.167,
"content_type": "video/mp4",
"status": "ready"
},
"error": null,
"error_code": null
}
]
}
}Use
data.jobId returned by video generation or video extension to query the job result.Authorizations
Obtain your API key from the TTAPI Dashboard.
Response
Query successful. The response status indicates the video job progress and result.
Last modified on November 21, 2026