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

Integração da API de Suno Speech

Use Suno Speech pela Rivya Public API v1 com o ID de modelo suno-speech, 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-speech

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-speechUse suno-speech como ID do modelo da API.
promptstringSim-Máximo de 5000 caracteres para este modelo.
paramsobjectNão-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
customModeselectNãofalse-false, trueModo
tonetextNão---Tom e interpretação
varietynumberNão-min 0 / max 4 / step 1-Variedade
vocalGenderselectNãof-f, mGênero vocal
backgroundMusicselectNãofalse-false, trueMúsica de fundo

Requisição mínima

{
  "model": "suno-speech",
  "prompt": "Boas-vindas. Veja uma breve apresentação do produto.",
  "params": {
    "customMode": "false"
  }
}

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_speech_example",
  "status": "queued",
  "model": "suno-speech",
  "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.