Suno Video

by SunoVideo

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:
Duration5–15srequested clip length
Resolution480p / 720pfast or standard
Output2 videosper generation request
Price12 quotaper second at 480p
Example clipVideo preview
Pink fluff performer

A pink fluffy puppet in glitter shoes performs in a Suno Visuals music video.

video-1
Examples

Suno Visuals official examples

Capabilities

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.

Pricing

Per-action, in quota

Usage is metered in quota by model, action, and output settings.

Suno video pricingOfficial pricing

Billed by requested duration. Each request produces two videos; the rate covers both outputs.

ResolutionPriceUnit
480p12 quota · $0.12/ second
720p24 quota · $0.24/ second
API request

Suno Video operations and request fields

Use the endpoint below with your TTAPI key and the request fields shown.

Text to videoPOST
/suno/v1/video/generate

Generate from a prompt and a duration of 5–15 seconds.

Official reference
First framePOST
/suno/v1/video/generate

Animate first_frame_url, optionally with reference images.

Official reference
First and last framePOST
/suno/v1/video/generate

Use first_frame_url and last_frame_url without reference images.

Official reference
Reference to videoPOST
/suno/v1/video/generate

Guide generation with up to 9 reference_image_urls.

Official reference
Song to videoPOST
/suno/v1/video/generate

Add song_id and an optional song_window; enable lip_sync when needed.

Official reference
FetchGET
/suno/v2/fetch

Pass 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 reference
POSThttps://api.ttapi.io/suno/v1/video/generate

Headers

TT-API-KEYstringrequired

TTAPI API key with Suno Video permission. Required for generation and result queries.

Content-Typestringrequired

application/json.

Body

promptstringrequired

Describe the scene, camera movement, and style in 1–30,000 characters.

durationintegerrequired

Requested video length: 5–15 seconds. Billing uses this duration.

resolutionenumoptional

480p (fast, default) or 720p (standard).

aspect_ratioenumoptional

1:1, 9:16 (default), 16:9, 4:3, or 3:4.

first_frame_urlstringoptional

Public HTTP(S) URL for a JPEG or PNG up to 10 MiB. Use alone, with a last frame, or with reference images.

last_frame_urlstringoptional

Public 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[]optional

Up to 9 public HTTP(S) URLs for JPEG or PNG images, each up to 10 MiB. May be combined with a first frame.

song_idstringoptional

Suno song ID for reference audio; can be combined with any supported image input.

song_windowobjectoptional

Requires 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_syncbooleanoptional

Defaults to false. Setting this to true enables lip sync and requires song_id.

hookUrlstringoptional

Public webhook URL. Receives an HTTP POST on completion with the same body as the video Fetch V2 response.

Open the official TTAPI documentation
Integrate

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"}'