Using Suno V6 in your workflow

Sorceress brings Suno models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

Add sound or speech to a creative workflow.
Integrate audio generation with your application using the model-specific parameters.

Pricing and availability

Flat 10 credits per generation (~2 variations), charged only on success.. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

Inputs and supported options

promptstring · optional

Simple mode: a description of the song. Advanced (customMode): the actual lyrics. Leave empty for auto-lyrics or instrumental.

customModeboolean · optional

false = Simple (describe the song). true = Advanced (provide lyrics + style + title). Default false.

instrumentalboolean · optional

true = no vocals. Default false.

modelstring · optional

Song engine version (optional). Leave unset to use the latest, highest-quality version.

stylestring · optional

Advanced only: musical style/genre tags (e.g. "epic orchestral, cinematic").

titlestring · optional

Advanced only: song title (max 80 chars).

negativeTagsstring · optional

Advanced only: styles to avoid.

vocalGenderstring · optional

Advanced only: "m" or "f" to bias the vocal.

weirdnessConstraintnumber · optional

Advanced only: 0–1 creativity/weirdness.

styleWeightnumber · optional

Advanced only: 0–1 how strongly to follow the style.

durationnumber · optional

Advanced only: optional target song length in seconds (10–360). Omit to let Suno choose the length.

Workflow actions

Music Generation

Generate a song (vocal or instrumental) from a description or custom lyrics/style. Async: returns a jobId — poll GET /api/v1/jobs/:id until it succeeds, then read result.tracks (~2 variations).

Flat 10 credits per generation (~2 variations), charged only on success.

Music · Stem Separation

Split a track into separate stems. mode "separate_vocal" gives vocals + instrumental (8 credits), "split_stem" gives up to 12 stems in one call (42 credits), "split_stem_advanced" isolates one precisely named instrument such as "Rhodes" or "Snare" (17 credits). Async: returns a jobId — poll GET /api/v1/jobs/:id, then read result.tracks (each stem has a title).

8 credits for 2-stem, 42 for a full multi-stem split, 17 for one named stem. Charged only on success.

Music · Stem Names

List every instrument name music_stems accepts in split_stem_advanced mode, grouped by family. Free and synchronous. Call this before requesting a specific stem. Note this is a fixed vocabulary — it does not report which instruments a particular song contains.

0 credits per successful call

Music · Add Instrumental

Generate instrumental backing around an uploaded vocal take, turning an acapella into a full song (Suno). The mirror of add-vocals. Async: returns a jobId — poll GET /api/v1/jobs/:id, then read result.tracks (~2 variations).

Flat 10 credits per generation (~2 variations), charged only on success.

Music · Cover Art

Generate album cover art for a finished Suno track from the song itself. Async: returns a jobId — poll GET /api/v1/jobs/:id, then read result.covers (2 images).

1 credit per track, charged only on success. Re-requesting an existing cover is free.

Music · Timestamped Lyrics

Get word-level start/end times for a generated track's lyrics, plus waveform data for visualisation. Use for karaoke displays, music-video subtitles, or syncing animation to words. Synchronous — returns the timings directly.

1 credit per call, charged only on success.

Music · Boost Style

Expand a terse style description (e.g. "Pop, Mysterious") into a richer Suno style prompt. Feed the result into music_generate's "style" in customMode. Synchronous — returns the text directly.

1 credit per call, charged only on success.

Ai Music API Create Music Video

Unicorn reference: 2 credits per video

Ai Music API Extend Music

Unicorn reference: 12 credits per track

Ai Music API Generate Lyrics

Unicorn reference: 1 credit per track

Ai Music API Generate MIDI from Audio

Unicorn reference: 1 credit per track

Ai Music API Generate Persona

Unicorn reference: 1 credit per track

Ai Music API Mashup

Unicorn reference: 12 credits per track

Ai Music API Replace Music Section

Unicorn reference: 5 credits per track

Ai Music API Upload And Convert to WAV Format

Unicorn reference: 1 credit per track

Ai Music API Upload And Cover Audio

Unicorn reference: 12 credits per track

AI Music API Upload And Extend Audio

Unicorn reference: 12 credits per track

API request template

Replace placeholders and choose valid values from the input contract.

POST /api/v1/tools/music_generate
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{}

Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.