Para agentes de IA

# 1. Crea una API key del lado del servidor en el dashboard
#    https://account.audiodeliverynetwork.com (Settings -> API Keys)
export ADN_API_KEY="adn_..."

# 2. Crea una colección
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 respuesta incluye collection_id

# 3. Crea una sesión de carga
#    Opcionalmente añade "track": { "file_name": "song.wav" } para crear también esa pista de antemano.
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 respuesta incluye upload_session_id

# 4. Crea una pista dentro de la sesión de carga (una solicitud por archivo; o para archivos adicionales tras una pista anidada).
#    Sin encabezado Authorization: el ID de la sesión de carga autoriza esta solicitud.
curl -X POST "https://api.audiodelivery.net/v1/upload/UPLOAD_SESSION_ID/track" \
  -H "Content-Type: application/json" \
  -d '{ "file_name": "song.wav" }'
# -> la respuesta incluye track_id y track_upload.upload_url

# 5. Sube los bytes de audio directamente a la URL firmada
curl -X PUT "$TRACK_UPLOAD_URL" --data-binary @song.wav

# 6. Espera a que termine el procesamiento (polling, o usa un webhook)
curl "https://api.audiodelivery.net/v1/track/TRACK_ID" \
  -H "Authorization: Bearer $ADN_API_KEY"
# -> repite hasta que track.track_status_id sea "ready"

# 7. Crea una play session para un oyente
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 respuesta incluye URLs de reproducción firmadas y con tiempo limitado en first_track.variants[].url

Ruta sin código (creador con un sitio web)

Si tu usuario solo quiere embeber audio en una página web, omite el flujo REST de arriba. Haz que suba vía el dashboard y embeba el snippet de abajo.

<!-- Para usuarios finales sin backend, embebe el player directamente. -->
<!-- Crea una clave Client-Side Player (acotada a una colección o pista) en el dashboard. -->
<!-- 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>

Recursos legibles por máquina

• /openapi.json — especificación OpenAPI 3.1 que cubre todos los endpoints v1.
• /llms.txt — resumen conciso del sitio en el formato llms.txt.
• /llms-full.txt — volcado completo del sitio, incluyendo inventario de endpoints y precios.
• /docs/llms-tree.md — árbol de docs en Markdown; cada página de docs también está disponible como Markdown limpio en su gemelo .md.
• /sitemap-index.xml — sitemap que cubre páginas de marketing y docs.

Configura tu agente de coding

Si eres un agente de coding de IA (o trabajas junto a uno) dentro del repositorio de un desarrollador, instala la guía de AudioDN y un validador con un solo comando. Escribe orientación segura para merge en los formatos que tu agente ya lee — AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/rules/audiodn.mdc, y un Skill portable en .agents/skills/audiodn/ — sin sobrescribir el contenido existente.

• npx @audiodn/agent-kit init — instala la guía en el repo actual.
• npx @audiodn/agent-kit validate . — busca errores comunes: una clave de servidor en código del cliente, endpoints inventados, una solicitud de carga por pista ausente, tratar una URL de carga como permanente, reproducción antes de ready, secretos hardcodeados o el host de API incorrecto.

Paquete: @audiodn/agent-kit en npm. La guía se deriva de la documentación canónica de este sitio y de la especificación OpenAPI, por lo que se mantiene coherente con la API.

Servidor Model Context Protocol (MCP)

Si tu asistente admite MCP (Cursor, Claude Desktop, Claude Code, VS Code, Codex y otros), el servidor MCP de AudioDN le permite llamar a la API directamente y consultar los endpoints canónicos sin adivinar. Expone herramientas de API en vivo (creators, collections, tracks, upload sessions, play sessions, variants) más herramientas de conocimiento offline de solo lectura basadas en la especificación OpenAPI y las docs de este sitio.

Hay dos formas de conectar:

• Endpoint alojado (remoto): apunta un cliente MCP con capacidad remota a https://mcp.audiodelivery.net/mcp (Streamable HTTP). Es público y no almacena secretos: las herramientas de conocimiento/docs funcionan sin clave, y habilitas las herramientas de API en vivo enviando tu API key de AudioDN en cada solicitud como Authorization: Bearer adn_… o X-ADN-API-Key: adn_…. Las herramientas de eliminación nunca se exponen en el endpoint alojado.
• Local (stdio): ejecuta npx @audiodn/mcp con una variable de entorno ADN_API_KEY establecida a una API key del lado del servidor.

• Las herramientas de lectura y conocimiento están anotadas como de solo lectura; las herramientas destructivas de eliminación se ocultan a menos que ejecutes el servidor local con ADN_MCP_ALLOW_DELETE=1.
• Las herramientas de conocimiento (adn_search_docs, adn_list_operations, adn_get_operation, adn_get_guide, adn_list_variant_types) funcionan offline a partir de snapshots canónicos incluidos.

Endpoint alojado: https://mcp.audiodelivery.net/mcp. Paquete: @audiodn/mcp en npm.

Ejemplos y proyectos ejecutables

Las guías prácticas están en /examples. Cada artículo cubre un flujo real con solicitudes HTTP, fragmentos de dependencias y una demo en vivo donde ayuda. Para apps completas que puedes clonar y ejecutar, consulta los proyectos del repositorio más abajo.

• /examples — índice de ejemplos indexable.
• Preparar audio para reproducción — cargar, procesar y reproducir.
• Optimizar para voz — variantes orientadas a voz.
• Player de clip de vista previa — vistas previas públicas cortas.

Dos proyectos ejecutables viven en el repositorio de AudioDN, cada uno con un README.md y un AGENTS.md: examples/nextjs-secure-upload (carga segura + reproducción en Next.js) y examples/cloudflare-worker-signed-playback (firma de URL en el edge). Ambos importan el @audiodn/recipe-kit compartido y sin dependencias (examples/shared).

Postura de confianza

• TLS 1.2+ en tránsito, AES-256 en reposo.
• URLs firmadas con TTL configurable; claves del lado del cliente acotadas a un solo recurso.
• Subprocesadores: Cloudflare (R2, Workers, caché edge), Stripe (facturación).
• No entrenamos modelos con tu audio.
• Estado: status.audiodeliverynetwork.com.

Si necesitas escalar

• Ventas: [email protected]
• Soporte: [email protected]
• Seguridad: [email protected]