Suno logoAudio

Suno API

Suno로 노래와 연주곡을 만들 수 있습니다. API 접근 방식은 서비스에 따라 다릅니다.

플레이그라운드

오디오 생성기

모델

Suno API
설정

아직 생성된 오디오가 없습니다

텍스트를 입력하고 생성 버튼을 눌러 오디오를 만드세요.

모델 소개

기능 및 사양

입력
텍스트
출력
오디오

Suno는 노래, 보컬, 연주곡 아이디어를 구현하는 음악 제작 플랫폼입니다. 자료에서 기반 모델의 버전이나 공식 공개 생성 API 제공 여부는 확인되지 않습니다. 이 페이지에서는 음악 제작 자료와 출처가 확인된 예시를 제공합니다.

오디오

예제

Suno 공식 음악 미리보기 예시

출처에 기록된 모델 출력입니다.

suno.com

Suno API 연동하기

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

자주 묻는 질문

Suno API 사양은 어디서 나오나요?

아래 참고 자료는 이 모델의 기능에 대한 출처를 나타냅니다. 통합 전에 서비스 제공업체와 현재의 접근 제한 및 가격 정보를 확인하십시오.

Suno API 사양은 어디서 나오나요?

사용 시 유의 사항

사용 전에 생성된 결과를 검토하세요. 사용 가능한 모드와 요청 제한은 선택한 서비스에 따라 다릅니다. 통합 전에 링크된 문서를 확인하세요.

모델 정보 출처

  • Suno API 참조