Für KI-Agenten

# 1. Serverseitigen API-Schlüssel im Dashboard erstellen
#    https://account.audiodeliverynetwork.com (Settings -> API Keys)
export ADN_API_KEY="adn_..."

# 2. Eine Collection erstellen
curl -X POST "https://api.audiodelivery.net/v1/collection" \
  -H "Authorization: Bearer $ADN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "My Collection" }'
# -> Antwort enthält collection_id

# 3. Eine Upload-Session erstellen
#    Optional "track": { "file_name": "song.wav" } hinzufügen, um diesen Track sofort mit anzulegen.
curl -X POST "https://api.audiodelivery.net/v1/upload_session" \
  -H "Authorization: Bearer $ADN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "collection_id": "COLLECTION_ID" }'
# -> Antwort enthält upload_session_id

# 4. Einen Track innerhalb der Upload-Session erstellen (eine Anfrage pro Datei; oder für weitere Dateien nach einem nested track).
#    Kein Authorization-Header — die Upload-Session-ID autorisiert diese Anfrage.
curl -X POST "https://api.audiodelivery.net/v1/upload/UPLOAD_SESSION_ID/track" \
  -H "Content-Type: application/json" \
  -d '{ "file_name": "song.wav" }'
# -> Antwort enthält track_id und track_upload.upload_url

# 5. Die Audio-Bytes direkt zur signierten URL hochladen
curl -X PUT "$TRACK_UPLOAD_URL" --data-binary @song.wav

# 6. Warten, bis die Verarbeitung fertig ist (pollen oder Webhook nutzen)
curl "https://api.audiodelivery.net/v1/track/TRACK_ID" \
  -H "Authorization: Bearer $ADN_API_KEY"
# -> wiederholen, bis track.track_status_id "ready" ist

# 7. Eine Play-Session für einen Hörer erstellen
curl -X POST "https://api.audiodelivery.net/v1/play_session/track" \
  -H "Authorization: Bearer $ADN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "track_id": "TRACK_ID", "variants": ["hq", "lq"] }'
# -> Antwort enthält signierte, zeitlich begrenzte Wiedergabe-URLs in first_track.variants[].url

No-Code-Pfad (Creator mit Website)

Wenn Ihr Nutzer Audio nur auf einer Webseite einbetten möchte, überspringen Sie den REST-Ablauf oben. Lassen Sie ihn über das Dashboard hochladen und das Snippet unten einbetten.

<!-- Für Endnutzer ohne Backend den Player direkt einbetten. -->
<!-- Client-Side Player-Schlüssel (auf Collection oder Track begrenzt) im Dashboard erstellen. -->
<!-- npm install @audiodn/components -->
<script type="module">
  import '@audiodn/components/player'
</script>

<audiodn-player
  api-key="CLIENT_SIDE_PLAYER_KEY"
  scope="track"
  id="TRACK_ID"
  variants="hq,lq"
  size="large"
></audiodn-player>

Maschinenlesbare Ressourcen

• /openapi.json — OpenAPI-3.1-Spezifikation aller v1-Endpunkte.
• /llms.txt — kurze Seitenzusammenfassung im llms.txt-Format.
• /llms-full.txt — vollständiger Site-Dump inkl. Endpunkt-Inventar und Preisen.
• /docs/llms-tree.md — Markdown-Docs-Baum; jede Docs-Seite ist auch als sauberes Markdown unter dem .md-Zwilling verfügbar.
• /sitemap-index.xml — Sitemap für Marketing-Seiten und Docs.

Coding-Agent einrichten

Wenn Sie ein KI-Coding-Agent sind (oder mit einem zusammenarbeiten) in einem Entwickler-Repository, installieren Sie AudioDN-Guidance und einen Validator mit einem Befehl. Er schreibt merge-sichere Guidance in den Formaten, die Ihr Agent bereits liest — AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/rules/audiodn.mdc und ein portables Skill unter .agents/skills/audiodn/ — ohne vorhandenen Inhalt zu überschreiben.

• npx @audiodn/agent-kit init — Guidance im aktuellen Repo installieren.
• npx @audiodn/agent-kit validate . — auf häufige Fehler prüfen: Server-Schlüssel im Client-Code, erfundene Endpunkte, fehlende Per-Track-Upload-Anfrage, Upload-URL als permanent behandeln, Wiedergabe vor ready, hardcodierte Secrets oder falscher API-Host.

Paket: @audiodn/agent-kit auf npm. Die Guidance basiert auf den kanonischen Docs dieser Site und der OpenAPI-Spezifikation und bleibt damit konsistent mit der API.

Model Context Protocol (MCP) Server

Wenn Ihr Assistent MCP unterstützt (Cursor, Claude Desktop, Claude Code, VS Code, Codex und andere), kann der AudioDN-MCP-Server die API direkt aufrufen und kanonische Endpunkte nachschlagen, ohne zu raten. Er stellt Live-API-Tools (Creators, Collections, Tracks, Upload Sessions, Play Sessions, Variants) sowie Offline-Read-only-Knowledge-Tools bereit, die auf der OpenAPI-Spezifikation und den Docs dieser Site basieren.

Es gibt zwei Verbindungswege:

• Gehosteter (Remote-)Endpunkt: einen remote-fähigen MCP-Client auf https://mcp.audiodelivery.net/mcp (Streamable HTTP) zeigen. Öffentlich und speichert keine Secrets: Knowledge-/Doc-Tools funktionieren ohne Schlüssel; Live-API-Tools aktivieren Sie, indem Sie Ihren AudioDN-API-Schlüssel bei jeder Anfrage als Authorization: Bearer adn_… oder X-ADN-API-Key: adn_… senden. Delete-Tools sind auf dem gehosteten Endpunkt nie freigegeben.
• Lokal (stdio): npx @audiodn/mcp mit einer ADN_API_KEY- Umgebungsvariable auf einen serverseitigen API-Schlüssel ausführen.

• Lese- und Knowledge-Tools sind als read-only annotiert; destruktive Delete-Tools sind ausgeblendet, sofern Sie den lokalen Server nicht mit ADN_MCP_ALLOW_DELETE=1 starten.
• Knowledge-Tools (adn_search_docs, adn_list_operations, adn_get_operation, adn_get_guide, adn_list_variant_types) arbeiten offline aus gebündelten kanonischen Snapshots.

Gehosteter Endpunkt: https://mcp.audiodelivery.net/mcp. Paket: @audiodn/mcp auf npm.

Beispiele und lauffähige Projekte

Praktische Walkthroughs finden Sie unter /examples. Jeder Artikel behandelt einen echten Workflow mit HTTP-Anfragen, Dependency-Snippets und einer Live-Demo, wo sie hilft. Für vollständige Apps, die Sie klonen und ausführen können, siehe die Repository-Projekte unten.

• /examples — crawlbarer Beispiel-Index.
• Prepare audio for playback — hochladen, verarbeiten und abspielen.
• Optimize for voice — sprachorientierte Variants.
• Preview clip player — kurze öffentliche Vorschauen.

Zwei lauffähige Projekte liegen im AudioDN-Repository, jeweils mit README.md und AGENTS.md: examples/nextjs-secure-upload (Next.js sicherer Upload + Wiedergabe) und examples/cloudflare-worker-signed-playback (Edge-URL-Signing). Beide importieren das gemeinsame, abhängigkeitsfreie @audiodn/recipe-kit (examples/shared).

Vertrauenshaltung

• TLS 1.2+ in Transit, AES-256 at Rest.
• Signierte URLs mit konfigurierbarer TTL; clientseitige Schlüssel auf eine einzelne Ressource begrenzt.
• Sub-Prozessoren: Cloudflare (R2, Workers, Edge-Cache), Stripe (Abrechnung).
• Wir trainieren keine Modelle mit Ihrem Audio.
• Status: status.audiodeliverynetwork.com.

Wenn Sie eskalieren müssen

• Vertrieb: [email protected]
• Support: [email protected]
• Sicherheit: [email protected]