Suno logoAudio

Suno API

O Suno permite criar músicas com vocais ou instrumentais. O acesso à API depende do serviço.

Área de testes

Gerador de áudio

Modelo

Suno API
Configurações

Nenhum áudio gerado ainda

Digite o texto e clique em Gerar para criar áudio.

Sobre este modelo

Recursos e especificações

Entrada
Texto
Saída
Áudio

O Suno é uma plataforma para criar músicas, vocais e faixas instrumentais. As fontes deixam em aberto a versão do modelo e a disponibilidade de uma API pública oficial de geração. Esta página reúne a documentação e uma amostra com indicação da fonte.

Áudio

Exemplos

Extrato de pré-visualização musical oficial da Suno

Saída do modelo documentada pela fonte.

suno.com

Desenvolva com Suno API

Gerenciar chaves de API
  • Bash
  • cURL >= 8.4
  • jq >= 1.6
  • uuidgen
bash
set -euo pipefail
: "${ONEASTER_API_KEY:?Set ONEASTER_API_KEY}"
base=$(printf '%s' 'aHR0cHM6Ly9hcGkub25lYXN0ZXIuYWkvdjE=' | jq -Rr '@base64d')
intent="${ONEASTER_INTENT_ID:-$(uuidgen)}"
printf 'Keep this intent and input: %s\n' "$intent" >&2
body=$(printf '%s' 'eyJraW5kIjoibXVzaWMiLCJtb2RlbCI6InN1bm8tbXVzaWMiLCJpbnB1dCI6eyJwcm9tcHQiOiJBIHF1aWV0IGNpbmVtYXRpYyBtZWxvZHkiLCJpc19pbnN0cnVtZW50YWwiOnRydWV9fQ==' | jq -Rr '@base64d')
work=$(mktemp -d)
trap 'rm -rf "$work"' EXIT
request() {
  curl --fail-with-body --silent --show-error --max-time 60 --max-filesize 8388608 \
    --header "Authorization: Bearer $ONEASTER_API_KEY" "$@"
}
if [ 'task' = 'sse' ]; then
  printf '%s' "$body" | request --no-buffer --request POST "$base/chat/completions" --header 'Content-Type: application/json' --header "Idempotency-Key: $intent" --data-binary @- |
  while IFS= read -r line; do
    case "$line" in
      'data: '*)
        data="${line#data: }"
        if [ "$data" = '[DONE]' ]; then touch "$work/done"; break; fi
        printf '%s\n' "$data" | jq -e 'if .error then error("Stream failed; inspect original intent") else . end' | jq -jr '.choices[]?.delta.content // empty'
        ;;
    esac
  done
  test -f "$work/done" || { printf 'Incomplete stream; keep intent %s\n' "$intent" >&2; exit 1; }
else
  if [ 'task' = 'transcription' ]; then
    [ -n "${ONEASTER_AUDIO_FILE:-}" ] || { printf 'Set ONEASTER_AUDIO_FILE to a PCM WAV file\n' >&2; exit 1; }
    size=$(wc -c < "$ONEASTER_AUDIO_FILE")
    [ "$size" -ge 44 ] && [ "$size" -le 8388608 ] || { printf 'PCM WAV must be 44 bytes to 8 MiB\n' >&2; exit 1; }
    request --request POST "$base/audio/transcriptions" --header "Idempotency-Key: $intent" \
      --form-string "model=$(printf '%s' "$body" | jq -er '.model')" \
      --form-string "language=$(printf '%s' "$body" | jq -r '.language // empty')" \
      --form 'file=@-;type=audio/wav;filename=input.wav' < "$ONEASTER_AUDIO_FILE" > "$work/accepted"
  else
    printf '%s' "$body" | request --request POST "$base/tasks" --header 'Content-Type: application/json' --header "Idempotency-Key: $intent" --data-binary @- > "$work/accepted"
  fi
  task=$(jq -er 'select(.success == true) | .data.id | select(test("^[0-9a-fA-F-]{36}$"))' "$work/accepted")
  deadline=$(( $(date +%s) + 600 ))
  complete=false
  while [ "$(date +%s)" -lt "$deadline" ]; do
    request "$base/tasks/$task" > "$work/task"
    state=$(jq -er 'select(.success == true) | .data.state' "$work/task")
    if [ "$state" = 'success' ]; then
      jq -e '.data.billing_state == "settled" and .data.artifact_available == true' "$work/task" > /dev/null
      case "$(jq -r '.data.kind' "$work/task")" in
        image) request "$base/tasks/$task/content" --output result.png;;
        music) request "$base/tasks/$task/content" --output result.mp3;;
        asr) jq -er '.data.artifact.text' "$work/task";;
        video) jq -er '.data.artifact.url' "$work/task";;
        *) printf 'Unsupported task kind\n' >&2; exit 1;;
      esac
      complete=true; break
    fi
    case "$state" in failed|rejected|unknown) printf 'Task %s ended: %s\n' "$task" "$state" >&2; exit 1;; esac
    sleep 2
  done
  [ "$complete" = true ] || { printf 'Polling deadline; retain task %s\n' "$task" >&2; exit 1; }
fi

Perguntas e respostas

De onde vêm as especificações Suno API?

As referências abaixo identificam as fontes de capacidades deste modelo. Confirme o acesso atual, os limites de solicitação e os preços com seu provedor de serviços antes da integração.

De onde vêm as especificações Suno API?

Pontos a considerar

Reveja os resultados gerados antes de usá-los. Os modos disponíveis e os limites de solicitação dependem do serviço escolhido; confira a documentação linkada antes da integração.

Fontes de informação do modelo

  • Referência Suno API