Suno · Áudio & Música

OpenClaw x Suno

Suno é uma plataforma de geração de música com IA que cria músicas originais — vocais, instrumentos e letras — a partir de descrições em texto. Pelo RunAPI, todas as versões do Suno compartilham uma única API key com cobrança por chamada.

9 variants a partir de $0.01 / chamada Uso comercial permitido
Obter chave de API Ver a documentação de OpenClaw

Prerequisite: npx runapi mcp install

Prompt

Modelos de prompt

Use suno-v4 quando ele corresponder à tarefa: Coerência e faixa de frequência aprimoradas, limite de 4 min.

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: Coerência e faixa de frequência aprimoradas, limite de 4 min
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_samples, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: Primeira geração de 8 min, 25% menos erros de gênero, 40% melhor voz
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/create_mashup, /api/v1/suno/extend_music, /api/v1/suno/add_samples, /api/v1/suno/stitch_audio, /api/v1/suno/inspire_music, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: Todos os estilos e modos do v4.5 desbloqueados sem limitação de assinatura
  endpoints: /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-plus: Tier de qualidade aprimorada dentro da arquitetura v4.5
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: Áudio CD-quality, até 8 min por geração
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/add_instrumental, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: Até 8 min por geração, clonagem de voz e treinamento de estilo
  endpoints: /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: Crie um beat lo-fi relaxante com piano suave, crepitar de vinil e uma linha de baixo delicada, 2 minutos.
/api/v1/suno/stitch_audio: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/stitch_audio e salve o ID da Task retornada.
Envie GET para /api/v1/suno/stitch_audio/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/extend_music: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/extend_music e salve o ID da Task retornada.
Envie GET para /api/v1/suno/extend_music/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/create_mashup: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/create_mashup e salve o ID da Task retornada.
Envie GET para /api/v1/suno/create_mashup/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/add_samples: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/add_samples e salve o ID da Task retornada.
Envie GET para /api/v1/suno/add_samples/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/cover_audio: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/cover_audio e salve o ID da Task retornada.
Envie GET para /api/v1/suno/cover_audio/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/inspire_music: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/inspire_music e salve o ID da Task retornada.
Envie GET para /api/v1/suno/inspire_music/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/text_to_music: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/text_to_music e salve o ID da Task retornada.
Envie GET para /api/v1/suno/text_to_music/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/remaster_audio: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/remaster_audio e salve o ID da Task retornada.
Envie GET para /api/v1/suno/remaster_audio/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/add_instrumental: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/add_instrumental e salve o ID da Task retornada.
Envie GET para /api/v1/suno/add_instrumental/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/add_vocals: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/add_vocals e salve o ID da Task retornada.
Envie GET para /api/v1/suno/add_vocals/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/suno/text_to_sound: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/suno/text_to_sound e salve o ID da Task retornada.
Envie GET para /api/v1/suno/text_to_sound/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.

Versões e endpoints públicos

O Suno V6 já está disponível. Requisições com IDs de modelo anteriores (v3.5–v5.5) são redirecionadas automaticamente para V6 ou V6 Mini. Os preços permanecem inalterados.
ID do modelo Endpoints Preço inicial Catálogo
suno-v4
/api/v1/suno/stitch_audio /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_samples /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/remaster_audio
$0.01 / chamada Detalhes do modelo
suno-v4.5
/api/v1/suno/remaster_audio /api/v1/suno/create_mashup /api/v1/suno/extend_music /api/v1/suno/add_samples /api/v1/suno/stitch_audio /api/v1/suno/inspire_music /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.01 / chamada Detalhes do modelo
suno-v4.5-all
/api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.12 / chamada Detalhes do modelo
suno-v4.5-plus
/api/v1/suno/cover_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.01 / chamada Detalhes do modelo
suno-v5
/api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/add_instrumental /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/add_vocals
$0.01 / chamada Detalhes do modelo
suno-v5.5
/api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/remaster_audio
$0.01 / chamada Detalhes do modelo
suno-v6
/api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/extend_music
$0.12 / chamada Detalhes do modelo
suno-v6-mini
/api/v1/suno/cover_audio /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / chamada Detalhes do modelo
suno-v6-wild
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / chamada Detalhes do modelo

Verificar

Consulte até que a Task alcance um estado final

Selecione <model-id> para gerar os comandos de verificação.

Configuração

Endpoint do guia: <endpoint>

Selecione <model-id> para gerar uma solicitação com o contrato público de entrada do endpoint.

Operações adicionais

Essas operações não usam um ID de modelo.

  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/generate_artwork
  • /api/v1/suno/generate_persona
  • /api/v1/suno/generate_midi
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_voice
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/voice_to_validation_phrase
  • /api/v1/suno/convert_audio
  • /api/v1/suno/visualize_music
  • /api/v1/suno/generate_lyrics
  • /api/v1/suno/blend_lyrics
  • /api/v1/suno/replace_section
Como funciona

Comece em 3 passos

  1. Escolha um ID de modelo

    Selecione um ID público do catálogo e confira seu endpoint e preço inicial atual.

  2. Configure o RunAPI

    Defina RUNAPI_API_KEY antes de enviar a solicitação ao endpoint.

  3. Verifique o resultado

    Para endpoints assíncronos, consulte o mesmo endpoint até que a Task alcance um estado final.

O que criar com OpenClaw + Suno

  • Música de fundo para YouTube e redes sociais

    Gere faixas de fundo originais para vídeos descrevendo o clima e o gênero em um prompt.

  • Ouvir uma letra como música completa

    Letristas podem enviar a letra com uma descrição de estilo e ouvi-la interpretada como uma demo completa antes do estúdio.

  • Vinhetas de abertura e encerramento de podcast

    Crie músicas instrumentais de abertura e encerramento no tom de um podcast, gere várias variações e escolha a melhor.

Por que usar Suno pelo RunAPI + OpenClaw

  • 9 variantes, uma chave de API

    Use uma única conexão do RunAPI para escolher entre as variantes de modelo disponíveis sem mudar sua integração.

  • Preços de uso claros

    Consulte os preços atuais do catálogo antes de enviar uma solicitação, sem assinatura ou gasto mínimo.

  • Fluxos de tarefas automáticos

    Envie tarefas, consulte seu status e reúna resultados assíncronos em um fluxo uniforme, sem escrever código de consulta manual.

Perguntas sobre OpenClaw + Suno

Como escrever prompts melhores para o Suno?

Seja específico sobre gênero, clima, andamento e instrumentação. Um prompt como “indie pop animado com violão e sintetizadores quentes” funciona melhor do que “música alegre”.

Posso estender uma música do Suno além do primeiro trecho?

Sim. O Suno na RunAPI tem endpoints para estender uma faixa, criar covers e combinar músicas, todos com a mesma chave de API e o mesmo ciclo de tarefas.

Preciso de uma conta do Suno para usá-lo pela RunAPI?

Não. A RunAPI oferece acesso programático ao Suno com sua chave de API e seu saldo da RunAPI. Não é preciso conta do Suno nem credenciais separadas.

Qual ID de modelo devo usar?

Escolha um ID público na tabela de versões. Cada ID expõe os endpoints mostrados em sua linha.

Este guia configura um modelo de chat?

Não. Esta linha de modelos usa o fluxo de endpoint mostrado aqui e não é apresentada como modelo de chat do agente.

Comece a usar Suno com OpenClaw

Obter chave de API Ler o Guia Rápido

Construindo com uma equipe?

Ajudamos com a configuração empresarial, integrações e dúvidas técnicas.

Fale conosco