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 aufrufen und kanonische Endpunkte nachschlagen, ohne zu raten. Bevorzugen Sie den gehosteten Endpoint https://mcp.audiodelivery.net/mcp mit OAuth-Kontoanmeldung (kein eingefügter API-Schlüssel). Lokales stdio über npx -y @audiodn/mcp wird ebenfalls unterstützt.

Vollständige Einrichtung, Client-Konfigurationen, Tool-Katalog und Ressourcen: /docs/mcp. Menschen: Start unter /explore/ai/. Paket: @audiodn/mcp auf npm.

Beispiele und lauffähige Projekte

Praktische Walkthroughs finden Sie unter /explore/. 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.

• /explore/ — crawlbarer Beispiel-Index.
• Prepare audio for playback — hochladen, verarbeiten und abspielen.
• Sprache verarbeiten — 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]