Suno API Docs

Overview of TTAPI Suno async generation, creation, stems, and audio editing endpoints

TTAPI Suno provides 12 asynchronous editing actions in addition to music and lyrics generation. Submit each action with POST /suno/submit/{ACTION}, then poll GET /suno/fetch/{task_id} using the returned task_id.

Channel models and billing

Add the corresponding models to the TTAPI channel before use: suno_extend, suno_cover, suno_upload_cover, suno_upload_extend, suno_stems, suno_stems_all, suno_add_vocals, suno_crop, suno_remove_section, suno_fade_in, suno_fade_out, and suno_adjust_speed. These extension models have no built-in default price; administrators must configure them explicitly under Model Pricing.

Creation and extension

EXTEND: continue an existing song using music_id and continue_at.
COVER: create a cover from an existing music_id.
UPLOAD_COVER: create a cover from a publicly accessible audio_url.
UPLOAD_EXTEND: continue a public audio URL from a specified timestamp.
ADD_VOCALS: add vocals to an existing song.

Depending on the endpoint, these actions accept custom, instrumental, mv, prompt, gpt_description_prompt, negative_tags, the three weight controls, duration, auto_lyrics, vocal_gender, persona_id, audio_format, and hookUrl.

Stems and editing

STEMS / STEMS_ALL: separate one selected stem or all stems.
CROP / REMOVE_SECTION: keep or remove a time range in seconds.
FADE_IN / FADE_OUT: add a fade at the beginning or end.
ADJUST_SPEED: change speed from 0.25x to 4x and optionally preserve pitch with keep_pitch.

Current scope

All 12 asynchronous task endpoints on this page are supported. TTAPI's synchronous file upload, file download, and WAV conversion endpoints do not use the async task system and are not currently exposed by the gateway Suno API. Upload-based tasks accept a publicly accessible audio_url instead.