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 autres), le serveur MCP AudioDN peut appeler l’API et retrouver les endpoints canoniques sans deviner. Préférez l’endpoint hébergé https://mcp.audiodelivery.net/mcp avec connexion OAuth (sans coller de clé API). Le stdio local via npx -y @audiodn/mcp est aussi pris en charge.

Configuration complète, configs client, catalogue d’outils et ressources : /docs/mcp. Humains : commencez sur /explore/ai/. Package : @audiodn/mcp sur npm.

Exemples et projets exécutables

Les guides pratiques sont sous /explore/. 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.

• /explore/ — index d’exemples indexable.
• Préparer l’audio pour la lecture — upload, traitement et lecture.
• Gérer 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]