Pour les agents IA

# 1. Créer une clé API côté serveur dans le tableau de bord
#    https://account.audiodeliverynetwork.com (Settings -> API Keys)
export ADN_API_KEY="adn_..."

# 2. Créer une collection
curl -X POST "https://api.audiodelivery.net/v1/collection" \
  -H "Authorization: Bearer $ADN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "My Collection" }'
# -> la réponse inclut collection_id

# 3. Créer une session d'upload
#    Optionnellement ajouter "track": { "file_name": "song.wav" } pour aussi créer cette piste d'emblée.
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" }'
# -> la réponse inclut upload_session_id

# 4. Créer une piste dans la session d'upload (une requête par fichier ; ou pour des fichiers supplémentaires après une piste imbriquée).
#    Pas d'en-tête Authorization — l'ID de session d'upload autorise cette requête.
curl -X POST "https://api.audiodelivery.net/v1/upload/UPLOAD_SESSION_ID/track" \
  -H "Content-Type: application/json" \
  -d '{ "file_name": "song.wav" }'
# -> la réponse inclut track_id et track_upload.upload_url

# 5. Téléverser les octets audio directement vers l'URL signée
curl -X PUT "$TRACK_UPLOAD_URL" --data-binary @song.wav

# 6. Attendre la fin du traitement (interrogation, ou utiliser un webhook)
curl "https://api.audiodelivery.net/v1/track/TRACK_ID" \
  -H "Authorization: Bearer $ADN_API_KEY"
# -> répéter jusqu'à ce que track.track_status_id soit "ready"

# 7. Créer une session de lecture pour un auditeur
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"] }'
# -> la réponse inclut des URL de lecture signées et limitées dans le temps dans first_track.variants[].url

Chemin sans code (créateur avec un site web)

Si votre utilisateur veut simplement intégrer de l’audio sur une page web, ignorez le flux REST ci-dessus. Faites-lui téléverser via le tableau de bord et intégrer l’extrait ci-dessous.

<!-- Pour les utilisateurs finaux sans backend, intégrez le player directement. -->
<!-- Créez une clé Client-Side Player (limitée à une collection ou une piste) dans le tableau de bord. -->
<!-- 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>

Ressources lisibles par machine

• /openapi.json — spécification OpenAPI 3.1 couvrant tous les endpoints v1.
• /llms.txt — résumé concis du site au format llms.txt.
• /llms-full.txt — dump complet du site incluant l’inventaire des endpoints et les tarifs.
• /docs/llms-tree.md — arborescence Markdown de la documentation ; chaque page de docs est aussi disponible en Markdown propre via son jumeau .md.
• /sitemap-index.xml — sitemap couvrant les pages marketing et la documentation.

Configurer votre agent de codage

Si vous êtes un agent de codage IA (ou travaillez aux côtés d’un) dans le dépôt d’un développeur, installez les conseils AudioDN et un validateur en une commande. Cela écrit des conseils fusionnables dans les formats que votre agent lit déjà — AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/rules/audiodn.mdc, et une Skill portable sous .agents/skills/audiodn/ — sans écraser le contenu existant.

• npx @audiodn/agent-kit init — installer les conseils dans le dépôt courant.
• npx @audiodn/agent-kit validate . — détecter les erreurs courantes : une clé serveur dans le code client, des endpoints inventés, une requête d’upload par piste manquante, traiter une URL d’upload comme permanente, lecture avant ready, secrets en dur, ou mauvais hôte API.

Package : @audiodn/agent-kit sur npm. Les conseils sont dérivés de la documentation canonique de ce site et de la spécification OpenAPI, pour rester cohérents avec l’API.

Serveur Model Context Protocol (MCP)

Si votre assistant prend en charge MCP (Cursor, Claude Desktop, Claude Code, VS Code, Codex, et d’autres), le serveur MCP AudioDN lui permet d’appeler l’API directement et de consulter les endpoints canoniques sans deviner. Il expose des outils API en direct (créateurs, collections, pistes, sessions d’upload, sessions de lecture, variantes) plus des outils de connaissance hors ligne, en lecture seule, ancrés dans la spécification OpenAPI et la documentation de ce site.

Il y a deux façons de se connecter :

• Endpoint hébergé (distant) : pointez un client MCP capable de remote vers https://mcp.audiodelivery.net/mcp (Streamable HTTP). Il est public et ne stocke aucun secret : les outils de connaissance/docs fonctionnent sans clé, et vous activez les outils API en direct en envoyant votre clé API AudioDN à chaque requête comme Authorization: Bearer adn_… ou X-ADN-API-Key: adn_…. Les outils de suppression ne sont jamais exposés sur l’endpoint hébergé.
• Local (stdio) : exécutez npx @audiodn/mcp avec une variable d’environnement ADN_API_KEY définie sur une clé API côté serveur.

• Les lectures et outils de connaissance sont annotés en lecture seule ; les outils de suppression destructifs sont masqués sauf si vous exécutez le serveur local avec ADN_MCP_ALLOW_DELETE=1.
• Les outils de connaissance (adn_search_docs, adn_list_operations, adn_get_operation, adn_get_guide, adn_list_variant_types) fonctionnent hors ligne à partir de snapshots canoniques inclus.

Endpoint hébergé : https://mcp.audiodelivery.net/mcp. Package : @audiodn/mcp sur npm.

Exemples et projets exécutables

Les guides pratiques sont sous /examples. Chaque article couvre un flux réel avec des requêtes HTTP, des extraits de dépendances et une démo en direct quand c’est utile. Pour des apps complètes à cloner et lancer, voir les projets du dépôt ci-dessous.

• /examples — index d’exemples indexable.
• Préparer l’audio pour la lecture — upload, traitement et lecture.
• Optimiser pour la voix — variantes orientées voix.
• Lecteur de clip d’aperçu — courts aperçus publics.

Deux projets exécutables vivent dans le dépôt AudioDN, chacun avec un README.md et un AGENTS.md : examples/nextjs-secure-upload (upload sécurisé Next.js + lecture) et examples/cloudflare-worker-signed-playback (signature d’URL edge). Les deux importent le @audiodn/recipe-kit partagé et sans dépendances (examples/shared).

Posture de confiance

• TLS 1.2+ en transit, AES-256 au repos.
• URL signées avec TTL configurable ; clés côté client limitées à une seule ressource.
• Sous-traitants : Cloudflare (R2, Workers, cache edge), Stripe (facturation).
• Nous n’entraînons pas de modèles sur votre audio.
• Statut : status.audiodeliverynetwork.com.

Si vous devez escalader

• Ventes : [email protected]
• Support : [email protected]
• Sécurité : [email protected]