Suno logoAudio

Suno API

Suno 音樂創作平台可製作歌曲與器樂,API 存取方式依服務而異。

線上試用

音訊生成器

模型

Suno API
設定

尚未生成音訊

輸入文字並按下生成,即可建立音訊。

模型介紹

能力與規格

輸入類型
文字
輸出類型
音訊

Suno 可用於構思歌曲、人聲和器樂作品。現有資料未確認底層模型版本,也未證實 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參考資料