Suno · Áudio & Música

Hermes Agent 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 Hermes Agent

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 Hermes Agent + Suno

  • Rascunhos para composição

    Descreva uma ideia de música com gênero, clima, andamento e tema e receba uma demo para desenvolver antes da produção em estúdio.

  • Covers em novos estilos

    Mude o estilo de uma faixa existente trocando gênero, instrumentação ou clima, mantendo a melodia e a estrutura.

  • Pipelines audiovisuais completos

    Encadeie o Suno com modelos de vídeo em um fluxo do Hermes Agent para criar imagens e uma trilha sonora original combinando.

Por que usar Suno pelo RunAPI + Hermes Agent

  • 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 Hermes Agent + Suno

Como configurar o Suno no Hermes Agent?

Use o mesmo provedor da RunAPI configurado para o chat. Ele atende endpoints de chat, imagem, vídeo e música, então o Suno não precisa de configuração separada.

Posso gerar faixas instrumentais sem vocais?

Sim. O Suno suporta geração instrumental. Os parâmetros de requisição nesta página mostram quais campos valem no modo instrumental, e a API retorna erro de validação se forem enviados campos conflitantes.

O Hermes Agent pode encadear o Suno com modelos de vídeo?

Sim. O Hermes Agent pode gerar um vídeo com um modelo de vídeo e depois criar uma trilha sonora combinando com o Suno no mesmo fluxo.

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 Hermes Agent

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