Für Sprache optimieren

Was du ausliefern kannst

Nutze dieses Muster, wann immer Sprache das Produkt ist: Voicemail, Support-Gesprächsarchive, IVR-Ansagen, Narration und Sprachnotizen. Diese Quellen sind meist Mono mit enger Dynamik — ein Multi-Megabyte-WAV (oder musikorientiertes HQ-AAC) dauerhaft zu behalten, verbraucht Speicher und Bandbreite ohne spürbaren Gewinn. Eine dedizierte voice-Variante gibt jedem Upload eine vorhersehbare, sprachoptimierte Datei für Player, Download-Endpunkte oder Cold Storage.

Das ist grob eine 20×–40×-Verkleinerung gegenüber dem Quell-WAV, bevor du das Original löschst. Im Bibliotheksmaßstab — Tausende Nachrichten — wechselst du von „alles für immer behalten“ zu „behalten, was Hörer tatsächlich abspielen“.

1. Beliebige Sprachaufnahme hochladen

Überspringe clientseitiges Crushing. Telefon-Apps, Zoom-Exporte, günstige Recorder und Studio-WAVs können in derselben Collection landen — AudioDN prüft die Datei und baut Varianten aus der besten verfügbaren Quelle. Bevorzuge beim Upload die höchste Qualität, die du hast (WAV / FLAC / AIFF wenn möglich), damit der Opus-Encode von einem sauberen Signal startet.

Dieser Walkthrough nutzt ein generiertes Anrufbeantworter-Sample — ein klassischer Piepton, gefolgt von einer aufdringlichen Mutter, die mit maximalem Timing fragt, wann endlich Enkelkinder kommen. Lade das Quell-WAV herunter, wenn du den Upload selbst ausführen willst: answering-machine-message.wav.

Upload-Session erstellen

# COLLECTION_ID: uuid of the collection to upload into
curl -X POST "https://api.audiodelivery.net/v1/upload_session" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "collection_id": "COLLECTION_ID",
  "expires_in": 7200
}'

// COLLECTION_ID: uuid of the collection to upload into

const payload = {
  "collection_id": "COLLECTION_ID",
  "expires_in": 7200
};

const response = await fetch('https://api.audiodelivery.net/v1/upload_session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# COLLECTION_ID: uuid of the collection to upload into

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "collection_id": "COLLECTION_ID",
    "expires_in": 7200
}

response = requests.post(
    "https://api.audiodelivery.net/v1/upload_session",
    headers=headers,
    json=payload,
)
data = response.json()

Spur in der Session erstellen

# SESSION_ID: upload_session_id from the previous call
curl -X POST "https://api.audiodelivery.net/v1/upload/SESSION_ID/track" \
  -H "Content-Type: application/json" \
  -d '{
  "file_name": "answering-machine-message.wav"
}'

// SESSION_ID: upload_session_id from the previous call

const payload = {
  "file_name": "answering-machine-message.wav"
};

const response = await fetch('https://api.audiodelivery.net/v1/upload/SESSION_ID/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# SESSION_ID: upload_session_id from the previous call

import requests

headers = {
    "Content-Type": "application/json",
}

payload = {
    "file_name": "answering-machine-message.wav"
}

response = requests.post(
    "https://api.audiodelivery.net/v1/upload/SESSION_ID/track",
    headers=headers,
    json=payload,
)
data = response.json()

Datei-Bytes hochladen

# PUT der Aufnahme-Bytes an track_upload.upload_url.
# Jedes unterstützte Audio funktioniert — starte mit der höchsten Qualität, die du hast (hier WAV).
curl -X PUT "$UPLOAD_URL" \
  --data-binary @answering-machine-message.wav \
  -H "Content-Type: audio/wav"

Polle GET /v1/track/:track_id, bis track_status_id ready ist. Organisationsweite Varianten werden in diesem Durchlauf fertig — einschließlich einer Original-Upload-Datei, falls dieses Rezept aktiviert ist. Details zur Upload-Session: Upload Sessions API.

2. In eine Voice-Opus-Variante transcodieren

Erstelle eine transcode-Variante namens voice mit codec: “opus”. Für Sprache starte bei 32 kbps Mono — deutlich kleiner als Musik-Presets, weiterhin verständlich auf Earbuds und Handys. Gehe auf 64 kbps, wenn du mehr Fidelity für verrauschte Quellen brauchst. Tags und Cover-Art entfernen; bei Voicemail verschwenden sie nur Bytes.

Konfiguriere das Rezept einmal im Dashboard, damit jeder Upload automatisch eine voice-Datei erhält, oder hänge es an eine fertige Spur mit der Variants API an (unten). Auf diesem Endpunkt sind nur lossy Codecs erlaubt — Opus ist genau das, was du hier willst.

Empfohlen: 32 kbps Mono Opus

# TRACK_ID: uuid of the ready track
curl -X POST "https://api.audiodelivery.net/v1/track/TRACK_ID/variant" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "variant_type_id": "transcode",
  "index": "voice",
  "codec": "opus",
  "bitrate": 32,
  "is_stereo": false,
  "is_strip_tags": true,
  "is_strip_cover": true
}'

// TRACK_ID: uuid of the ready track

const payload = {
  "variant_type_id": "transcode",
  "index": "voice",
  "codec": "opus",
  "bitrate": 32,
  "is_stereo": false,
  "is_strip_tags": true,
  "is_strip_cover": true
};

const response = await fetch('https://api.audiodelivery.net/v1/track/TRACK_ID/variant', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# TRACK_ID: uuid of the ready track

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "variant_type_id": "transcode",
    "index": "voice",
    "codec": "opus",
    "bitrate": 32,
    "is_stereo": False,
    "is_strip_tags": True,
    "is_strip_cover": True
}

response = requests.post(
    "https://api.audiodelivery.net/v1/track/TRACK_ID/variant",
    headers=headers,
    json=payload,
)
data = response.json()

Optional: 64 kbps, wenn du mehr Headroom brauchst

# TRACK_ID: uuid of the ready track
curl -X POST "https://api.audiodelivery.net/v1/track/TRACK_ID/variant" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "variant_type_id": "transcode",
  "index": "voice",
  "codec": "opus",
  "bitrate": 64,
  "is_stereo": false,
  "is_strip_tags": true,
  "is_strip_cover": true
}'

// TRACK_ID: uuid of the ready track

const payload = {
  "variant_type_id": "transcode",
  "index": "voice",
  "codec": "opus",
  "bitrate": 64,
  "is_stereo": false,
  "is_strip_tags": true,
  "is_strip_cover": true
};

const response = await fetch('https://api.audiodelivery.net/v1/track/TRACK_ID/variant', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# TRACK_ID: uuid of the ready track

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "variant_type_id": "transcode",
    "index": "voice",
    "codec": "opus",
    "bitrate": 64,
    "is_stereo": False,
    "is_strip_tags": True,
    "is_strip_cover": True
}

response = requests.post(
    "https://api.audiodelivery.net/v1/track/TRACK_ID/variant",
    headers=headers,
    json=payload,
)
data = response.json()

Die Spur geht erneut in processing, während Opus gebaut wird, und kehrt dann zu ready zurück. Parameterreferenz: Variants API.

3. Das Original löschen, wenn du zufrieden bist

Solange du Rezepte noch feinabstimmst, behalte den Original Upload, damit du Varianten neu erzeugen kannst. Sobald voice richtig klingt und du keine erneute Verarbeitung mehr brauchst, lösche das Original, um das große WAV (oder eine andere Quelle) aus dem Speicher freizugeben. Danach kann AudioDN für diese Spur keine neuen Varianten mehr erzeugen — nur die verbleibenden Dateien (wie voice) bleiben für Wiedergabe und Download verfügbar.

Im Dashboard die Spur öffnen → files / variants, bestätigen dass voice ready ist, dann den Original Upload entfernen. Siehe Original Upload zum Trade-off: Originale sind Versicherung; nachdem du mit dem Opus-Ergebnis zufrieden bist, sind sie meist teure Nostalgie.

4. Nur die Voice-Variante abspielen

Richte den Player auf die Spur und fordere variants=“voice” mit einem Client-Side-Player-Schlüssel an. Hörer laden nie die Multi-Megabyte-Quelle herunter — nur die Opus-Datei, die du behalten hast.

npm install @audiodn/components

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/player.js"></script>

<script type="module">
  import '@audiodn/components/player';
</script>

<audiodn-player
  api-key="YOUR_PLAYER_API_KEY"
  scope="track"
  id="9b46405d-edc0-497c-9c36-4c97ceb15337"
  variants="voice"
  size="regular"
></audiodn-player>

Live-Demo

Die Wiedergabe ist die voice-Opus-Variante des Anrufbeantworter-Samples — so hörst du den Footprint, den du ausliefern kannst.

Weitere Player-Optionen: Player component docs.

Checkliste

• Lade die höchste Qualität der Sprachquelle hoch, die du hast (WAV gezeigt; jedes unterstützte Format funktioniert).

• Eine voice-Transcode existiert mit codec: “opus”, Mono und 32 (oder 64) kbps.

• Höre variants=“voice” und bestätige, dass die Sprachqualität für dein Produkt ausreicht.
• Lösche den Original Upload, wenn du Varianten nicht mehr neu erzeugen musst — behalte nur das günstige Opus-Archiv.