curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header 'Content-Type: application/json' \
--header 'TT-API-KEY: <api-key>' \
--data '
{
"prompt": "A paper lantern slowly rises into the starry sky as the camera follows it upward.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "9:16",
"hookUrl": "https://example.com/webhooks/suno-video"
}
'{
"status": "SUCCESS",
"message": "success",
"data": {
"jobId": "video-9c64b7e1-f00d-456e-8c56-a0227f5128fb"
}
}{
"status": "FAILED",
"message": "<string>",
"data": {}
}{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}Suno
Suno Video Generation API
Generate videos from text, images, or Suno reference audio, and use Fetch V2 to retrieve asynchronous results.
POST
/
suno
/
v1
/
video
/
generate
curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header 'Content-Type: application/json' \
--header 'TT-API-KEY: <api-key>' \
--data '
{
"prompt": "A paper lantern slowly rises into the starry sky as the camera follows it upward.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "9:16",
"hookUrl": "https://example.com/webhooks/suno-video"
}
'{
"status": "SUCCESS",
"message": "success",
"data": {
"jobId": "video-9c64b7e1-f00d-456e-8c56-a0227f5128fb"
}
}{
"status": "FAILED",
"message": "<string>",
"data": {}
}{
"status": "FAILED",
"message": "Wrong TT-API-KEY or email is not activated."
}Input Methods
| Generation Method | Image Parameters |
|---|---|
| Text to video | Provide only a prompt and duration; optionally set the resolution, model, and aspect ratio |
| From a first frame | first_frame_url |
| First and last frames | first_frame_url and last_frame_url |
| Reference images | reference_image_urls, up to 9 images |
| First frame with reference images | first_frame_url and reference_image_urls |
song_id, use song_window.start_s and song_window.end_s to specify a reference window whose length must equal duration. If no window is provided, the required duration is taken from the beginning of the song. lip_sync: true requires song_id.Authorizations
You can obtain your API key from the TTAPI Dashboard.
Body
application/json
Last modified on November 20, 2026