/MUSIC/suno

Áudio

Lançado em 9 de setembro de 2026

API de Suno

Geração de áudio Suno: crie músicas, letras e efeitos sonoros e edite faixas existentes (estender, cobrir, hastes, fades, mashup, remasterizar, MV, persona e muito mais) — um modelo selecionado pelo campo `ação`.

Texto para música
Referência de áudio
Múltiplas ações

Testar modelo Obter chave de API Documentação

A partir de

$0.075

por geração

53 parâmetros · 31 opções de preço

Playground do Suno

Entrada

Prompt

Custom mode: detailed lyrics / prompt (also the lyrics or sound description)

Audio URL

Audio file URL to operate on

Image URL

music-video: cover image URL to show inside the ring (default: the source track's cover art when available)

Voice Audio URL

voice: URL to the voice recording

Verification Audio URL

voice: URL to the verification-phrase recording

Audio URLs

Public audio URLs. inspo: 1–4 inspiration references; custom-model: 6–24 training tracks (MP3, WAV or M4A).

Faça login para executar

As execuções são cobradas do seu saldo.

Saída

A saída aparecerá aqui.

Preencha os campos, verifique o custo e execute o modelo. O resultado aparecerá aqui; não precisa de uma chave API separada para experimentar no navegador.

Preços da API do Suno

Opção	Preço por geração
music	$0.075
bpm	$0.002
vox	$0.002
wav	$0.002
concat	$0.002
boost-style	$0.002
music-video	$0.002
timestamped-lyrics	$0.002
upload	$0.006
crop	$0.012
lyrics	$0.012
fade-in	$0.012
fade-out	$0.012
remove-section	$0.012
sound	$0.015
voice	$0.024
adjust-speed	$0.036
midi	$0.075
cover	$0.075
extend	$0.075
mashup	$0.075
sample	$0.075
add-stem	$0.075
remaster	$0.075
add-vocals	$0.075
music-cover	$0.075
replace-section	$0.075
add-instrumental	$0.075
inspo	$0.102
stems	$0.15
stems-all	$0.36

Início rápido

Referência completa da API →

1curl -X POST https://api.api-stock.com/api/v1/generation/create \
2  -H "Authorization: Bearer $API_STOCK_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "suno",
6    "input": {
7      "action": "music",
8      "makeInstrumental": false,
9      "maxMode": false,
10      "aspectRatio": "9:16",
11      "quality": "compact"
12    }
13  }'

Parâmetros

Nome	Tipo	Obrigatório	Padrão	Descrição
`action`	string	Não	music	Suno operationUm dos seguintes: music, extend, cover, add-instrumental, add-vocals, sound, stems, stems-all, wav, lyrics, voice, timestamped-lyrics, boost-style, music-cover, replace-section, music-video, inspo, upload, remaster, add-stem, vox, remove-section, crop, fade-in, fade-out, adjust-speed, concat, mashup, sample, midi, bpm, custom-model
`mv`	string	Não	—	Versão do motor. Ações de áudio: v6 (padrão) \| v6-wild \| v6-mini \| custom. As versões descontinuadas v3.5 … v5.5 continuam aceitas e rodam no v6. lyrics: remi-v1 \| default. Não é usado por stems/stems-all/wav/voice. variety, maxMode, audioFormat, duration e customModelId exigem um motor V6 (qualquer valor exceto custom).
`custom`	boolean	Não	—	false for simple mode, true for custom mode
`gptDescriptionPrompt`	string	Não	—	Simple mode: song / effect description (with optional lyrics)
`prompt`	string	Não	—	Custom mode: detailed lyrics / prompt (also the lyrics or sound description)
`tags`	string	Não	—	Custom mode: genre / style tags
`title`	string	Não	—	Title for the result
`makeInstrumental`	boolean	Não	false	Generate an instrumental-only track
`negativeTags`	string	Não	—	Styles to avoid (custom mode / sound)
`personaId`	string	Não	—	ID of a custom voice (persona) to sing the generated music
`customModel`	object	Não	—	Inline custom model definition (required when mv=custom)
`customModelId`	string	Não	—	Id of a reusable custom model created by the `custom-model` action (its `output.customModelId`). Generates in that model's style; cannot be combined with mv or personaId.
`variety`	string	Não	—	Style variation: off \| normal \| high \| extra \| max. V6 generative actions.Um dos seguintes: off, normal, high, extra, max
`maxMode`	boolean	Não	false	Max mode: higher-quality V6 generation, billed at twice the regular price. Requires custom mode, except on inspo and replace-section.
`audioFormat`	string	Não	—	Output audio format: mp3 \| m4a \| wav. V6 generative actions plus sound, remaster, stems and stems-all.Um dos seguintes: mp3, m4a, wav
`duration`	number	Não	—	music / extend / cover: target length in seconds (10–360), custom mode only. The actual length is decided by the model.
`audioUrl`	string	Não	—	Audio file URL to operate on
`continueAt`	number	Não	—	extend: time in seconds where the extension should begin (at least 1 for a sourceTaskId or audioUrl source)
`sourceTaskId`	string	Não	—	Reference to one of your prior Suno generations (its taskId), used by stateful actions such as extend, music-cover, replace-section, timestamped-lyrics, music-video, voice and wav.
`audioId`	string	Não	—	The track to operate on, identified by its id (as returned in a prior generation's `output.tracks[].audioId`). A generation usually produces 2 tracks; omit to use the first.
`fullLyrics`	string	Não	—	replace-section: complete lyrics for the whole track after the edit
`author`	string	Não	—	music-video: artist / creator name on the cover (max 50)
`domainName`	string	Não	—	music-video: brand / site watermark at the bottom (max 50)
`aspectRatio`	string	Não	9:16	music-video: output aspect ratioUm dos seguintes: 9:16, 16:9, 1:1, 3:4, 4:3
`backgroundColors`	string[]	Não	—	music-video: 1–4 hex colors for the blurred gradient backdrop (e.g. ["#1B2635", "#8A6A4F"])
`imageUrl`	string	Não	—	music-video: cover image URL to show inside the ring (default: the source track's cover art when available)
`quality`	string	Não	compact	music-video: output quality. `compact` — small share-friendly file (~5MB / 3 min); `high` — sharper 720p-class output at roughly double the size; `max` — 1080p-class, ~4× compactUm dos seguintes: compact, high, max
`startS`	number	Não	—	Start time (seconds) of the affected range. Used by remove-section / crop / sample (the range), replace-section (the infill range) and vox / voice-from-track (the vocal window).
`endS`	number	Não	—	End time (seconds) of the affected range (> startS). See startS for the actions that use it.
`bpm`	number	Não	—	sound: tempo in BPM
`key`	string	Não	—	sound: musical key (Major C–B; Minor Cm–Bm)
`type`	string	Não	—	sound: 'one-shot' or 'loop' (defaults to one-shot)Um dos seguintes: one-shot, loop
`voiceAudioUrl`	string	Não	—	voice: URL to the voice recording
`verificationAudioUrl`	string	Não	—	voice: URL to the verification-phrase recording
`phraseId`	string	Não	—	voice: phrase ID from the verification-phrase endpoint
`name`	string	Não	—	voice / custom-model: name
`description`	string	Não	—	voice: description
`styles`	string	Não	—	voice: genre tags (e.g. 'funk edm')
`singerSkillLevel`	string	Não	—	voice: singer skill levelUm dos seguintes: Beginner, Intermediate, Advanced, Professional
`audioUrls`	string[]	Não	—	Public audio URLs. inspo: 1–4 inspiration references; custom-model: 6–24 training tracks (MP3, WAV or M4A).
`styleWeight`	number	Não	—	Style weight (0.00–1.00)
`weirdnessConstraint`	number	Não	—	Creativity / weirdness weight (0.00–1.00)
`audioWeight`	number	Não	—	Audio weight (0.00–1.00)
`vocalGender`	string	Não	—	Vocal gender: Male or FemaleUm dos seguintes: Male, Female
`autoLyrics`	boolean	Não	—	inspo: rewrite the provided lyrics creatively
`variationCategory`	string	Não	—	remaster: intensity (subtle / normal / high)Um dos seguintes: subtle, normal, high
`stemType`	string	Não	—	stems: which stem to extract (e.g. lead_vocal, backing_vocals, drum_kit, bass, piano, electric_guitar). Defaults to lead_vocal.
`voxAudioId`	string	Não	—	Deprecated and ignored: a persona is now created straight from the track (voice with sourceTaskId), no vox extraction needed.
`durationS`	number	Não	—	fade-in / fade-out: fade duration in seconds
`speed`	number	Não	—	adjust-speed: speed multiplier (0.25–4)
`keepPitch`	boolean	Não	—	adjust-speed: keep the original pitch (defaults to true)
`sourceTaskIds`	string[]	Não	—	mashup: exactly 2 prior suno generation ids (taskIds) to remix together
`audioIds`	string[]	Não	—	mashup: parallel array to sourceTaskIds selecting the track in each source by its audioId (as returned in output.tracks[].audioId); omit an entry to use that source's first track

Perguntas frequentes

Quanto custa Suno?

Suno começa em $0.075 por geração pela API da API Stock. Você paga por uso a partir de um único saldo pré-pago — não há assinatura — e o preço final varia de acordo com parâmetros como resolução ou duração.

Quando o Suno foi lançado?

O Suno foi lançado em 9 de setembro de 2026. Ele está disponível pela API da API Stock com a mesma chave e o mesmo saldo pré-pago de todos os outros modelos.

Como obtenho uma chave de API para Suno?

Cadastre-se na API Stock, recarregue seu saldo com um método de pagamento disponível e crie uma chave de API no painel — leva poucos minutos e não exige contrato. A mesma chave funciona com todos os modelos do catálogo, portanto não é preciso obter uma chave separada para Suno.

Como faço uma chamada à API Suno?

Envie uma solicitação POST para https://api.api-stock.com/api/v1/generation/create com sua chave de API e o ID do modelo "suno". A chamada retorna um ID de tarefa que você consulta, ou um callback de webhook quando o resultado estiver pronto. Há um exemplo pronto para execução no início rápido acima.

Quais parâmetros de entrada Suno aceita?

Suno aceita 53 parâmetros de entrada. Seus tipos, valores padrão e valores permitidos estão listados na tabela de parâmetros acima.

O que acontece se uma solicitação para Suno falhar?

A API Stock tenta automaticamente a solicitação novamente usando um provedor de reserva. Se todos os provedores falharem, o valor cobrado será reembolsado ao seu saldo.

Posso usar Suno com a mesma chave de API que outros modelos?

Sim. Todos os modelos da API Stock — vídeo, imagem, música e chat — compartilham uma única chave de API e um único saldo pré-pago, então você pode mudar para Suno sem novas credenciais.