↓
Documentação da Rivya AI
Páginas de API por modelo

Integração da API de Suno Music

Use Suno Music pela Rivya Public API v1 com o ID de modelo suno-music, entradas compatíveis, parâmetros, regras da Files API, créditos e exemplos de resposta.

Disponível via APIInput de texto prontoÁudio
ID do modelo da API

suno-music

Entradas

text

Files API

Não obrigatório para a requisição mínima

Créditos base

Taxa em créditos: 12 / solicitação O custo final da tarefa é arredondado para cima em créditos inteiros.

Capacidade

Áudio

Cobrança

FIXED

Limite de prompt

5000 caracteres

Contrato da requisição

Envie o ID do modelo no nível superior. Controles específicos do modelo ficam em params.

ChaveTipoObrigatórioPadrãoDescrição
modelstringSimsuno-musicUse suno-music como ID do modelo da API.
promptstringNão-Máximo de 5000 caracteres para este modelo.
paramsobjectSim-Objeto de parâmetros específico do modelo. Use as linhas abaixo para ver as chaves permitidas.
client_request_idstringNão-ID opcional do cliente para rastrear requisições no seu sistema.

Parâmetros do modelo

ChaveTipoObrigatórioPadrãoIntervaloOpçõesDescrição
modelselectNãoV6-V6, V6_MINI, V6_WILDVersão do modelo
instrumentalselectNãotrue-true, falseInstrumental
titletextSim---Título
styletextSim---Estilo musical
durationnumberNão30min 10 / max 360 / step 1-Duração (segundos)

Requisição mínima

{
  "model": "suno-music",
  "prompt": "Boas-vindas. Veja uma breve apresentação do produto.",
  "params": {
    "model": "V6",
    "instrumental": "false",
    "duration": 30,
    "title": "Suno Music",
    "style": "Folk acústico, ritmo suave, voz acolhedora"
  }
}

Resposta de criação

O endpoint de criação retorna um ID público de tarefa. Consulte o endpoint de status até a tarefa ser concluída ou falhar.

{
  "id": "task_suno_music_example",
  "status": "queued",
  "model": "suno-music",
  "reserved_credits": 12,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

O endpoint de criação retorna um ID público de tarefa. Consulte o endpoint de status até a tarefa ser concluída ou falhar.