Suno Video
Suno Video API on TTAPI uses video-1 to create 5–15 second clips from text, frames, or reference images, with optional Suno song audio and lip sync at 480p or 720p.
Last updated:Suno Visuals official examples
What you can build with Suno Video
Text to video
Describe a scene and choose a duration, aspect ratio, and resolution.
Frame and reference control
Start with a first frame, set first and last frames, or guide the video with up to 9 images.
Suno audio and lip sync
Reference an existing Suno song and select a matching audio window; lip sync requires song_id.
Two video outputs
Submit once, then fetch with jobId or receive a webhook. Inspect each returned video status and URL.
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
Billed by requested duration. Each request produces two videos; the rate covers both outputs.
Suno Video operations and request fields
Use the endpoint below with your TTAPI key and the request fields shown.
/suno/v1/video/generateGenerate from a prompt and a duration of 5–15 seconds.
Official reference/suno/v1/video/generateAnimate first_frame_url, optionally with reference images.
Official reference/suno/v1/video/generateUse first_frame_url and last_frame_url without reference images.
Official reference/suno/v1/video/generateGuide generation with up to 9 reference_image_urls.
Official reference/suno/v1/video/generateAdd song_id and an optional song_window; enable lip_sync when needed.
Official reference/suno/v2/fetchPass data.jobId from the submit response as the jobId query parameter. Check for ON_QUEUE, SUCCESS, or FAILED. Inspect each video status and video_url in data.videos.
Official referenceHeaders
TT-API-KEYstringrequiredTTAPI API key with Suno Video permission. Required for generation and result queries.
Content-Typestringrequiredapplication/json.
Body
promptstringrequiredDescribe the scene, camera movement, and style in 1–30,000 characters.
durationintegerrequiredRequested video length: 5–15 seconds. Billing uses this duration.
resolutionenumoptional480p (fast, default) or 720p (standard).
aspect_ratioenumoptional1:1, 9:16 (default), 16:9, 4:3, or 3:4.
first_frame_urlstringoptionalPublic HTTP(S) URL for a JPEG or PNG up to 10 MiB. Use alone, with a last frame, or with reference images.
last_frame_urlstringoptionalPublic HTTP(S) URL for a JPEG or PNG up to 10 MiB. Requires first_frame_url and cannot be used with reference_image_urls.
reference_image_urlsstring[]optionalUp to 9 public HTTP(S) URLs for JPEG or PNG images, each up to 10 MiB. May be combined with a first frame.
song_idstringoptionalSuno song ID for reference audio; can be combined with any supported image input.
song_windowobjectoptionalRequires song_id. Both start_s and end_s accept nonnegative numbers in seconds. start_s defaults to 0, end_s defaults to start_s + duration, and the window length must equal duration.
lip_syncbooleanoptionalDefaults to false. Setting this to true enables lip sync and requires song_id.
hookUrlstringoptionalPublic webhook URL. Receives an HTTP POST on completion with the same body as the video Fetch V2 response.
From key to first result
Copy the resolved endpoint, authentication headers, and request body for this model.
curl --request POST \
--url https://api.ttapi.io/suno/v1/video/generate \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{"prompt":"A paper lantern rises into a starry sky as the camera follows it upward.","duration":5,"resolution":"480p","aspect_ratio":"9:16"}'