Estandarizar audio cargado para una reproducción fiable

De un vistazo

Cómo encaja el flujo

Una carga compatible se convierte en un archivo reproducible y consistente en cuatro pasos gestionados. El procesamiento debe completarse antes de la reproducción, así que tu aplicación espera a que la pista esté ready y luego solicita la variante por nombre.

Audio de origen compatible (WAV, FLAC, MP3, ...)
        |
        v
Cargar a AudioDN
        |
        v
AudioDN procesa la pista           (track_status_id: processing)
        |
        v
Variante configurada generada      (track_status_id: ready)
        |
        v
Reproduce la misma variante con nombre en web, móvil o servidor

1. Configura primero la salida

La variante de transcode es la función sobre la que realmente trata este ejemplo. Una variante es una receta reutilizable que indica a AudioDN cómo convertir cualquier carga compatible en una salida concreta. Configúrala una vez y AudioDN genera esa misma variante con nombre para las nuevas cargas automáticamente — tu código nunca tiene que detectar ni especializar el codec de origen, y siempre solicita el resultado por el mismo nombre.

Por qué AAC a 128 kbps

AAC es un valor práctico por defecto para reproducción web y en apps en general: está ampliamente soportado en navegadores modernos, sistemas operativos móviles y players de medios, y 128 kbps ofrece un equilibrio útil entre calidad, tamaño de archivo y rendimiento de streaming para la escucha típica. AudioDN entrega esta variante con el content type audio/aac. Si tu producto necesita otros compromisos, configura un codec o bitrate distinto, o añade más variantes — consulta Tipos de variantes.

2. Sube el origen

No importa cómo llegue el archivo — un master de estudio sin pérdida, un memo de voz comprimido o lo que haya producido el teléfono de un oyente. La carga es una secuencia corta y explícita: crea una sesión (opcionalmente con un track anidado para crear la primera pista de antemano), crea las pistas adicionales, haz PUT de los bytes a la URL de carga de la pista y luego espera hasta que la pista esté ready.

POST /v1/upload_session                       -> upload_session_id
  (objeto track anidado opcional)              -> también track_id + track_upload.upload_url
POST /v1/upload/{upload_session_id}/track     -> track_upload.upload_url  (por cada archivo adicional)
PUT  {track_upload.upload_url}                  (enviar los bytes de origen)
GET  /v1/track/{track_id}                       (polling hasta track_status_id = ready)
Solicitar la variante configurada              (p. ej. variants="aac")

Luego haz polling de GET /v1/track/:track_id hasta que track_status_id sea ready, o escucha un webhook de pista, antes de iniciar la reproducción.

# COLLECTION_ID: uuid de la colección a la que subir
curl -X POST "https://api.audiodelivery.net/v1/upload_session" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "collection_id": "COLLECTION_ID",
  "expires_in": 7200
}'

// COLLECTION_ID: uuid de la colección a la que subir

const payload = {
  "collection_id": "COLLECTION_ID",
  "expires_in": 7200
};

const response = await fetch('https://api.audiodelivery.net/v1/upload_session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# COLLECTION_ID: uuid de la colección a la que subir

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "collection_id": "COLLECTION_ID",
    "expires_in": 7200
}

response = requests.post(
    "https://api.audiodelivery.net/v1/upload_session",
    headers=headers,
    json=payload,
)
data = response.json()

# SESSION_ID: upload_session_id devuelto por la llamada anterior
curl -X POST "https://api.audiodelivery.net/v1/upload/SESSION_ID/track" \
  -H "Content-Type: application/json" \
  -d '{
  "file_name": "track.wav"
}'

// SESSION_ID: upload_session_id devuelto por la llamada anterior

const payload = {
  "file_name": "track.wav"
};

const response = await fetch('https://api.audiodelivery.net/v1/upload/SESSION_ID/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

# SESSION_ID: upload_session_id devuelto por la llamada anterior

import requests

headers = {
    "Content-Type": "application/json",
}

payload = {
    "file_name": "track.wav"
}

response = requests.post(
    "https://api.audiodelivery.net/v1/upload/SESSION_ID/track",
    headers=headers,
    json=payload,
)
data = response.json()

# Tras create-track, que devuelve track_upload.upload_url, haz PUT de los bytes de origen.
# Cualquier formato de origen compatible funciona, independientemente de su calidad o codec original.
curl -X PUT "$UPLOAD_URL" \
  --data-binary @track.wav \
  -H "Content-Type: audio/wav"

npm install @audiodn/components

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/uploader.js"></script>

<script type="module">
import '@audiodn/components/uploader';
</script>

<audiodn-uploader
api-key="YOUR_UPLOAD_API_KEY"
collection-id="COLLECTION_ID"
></audiodn-uploader>

3. Reproduce la variante

Una vez que la pista está ready, cada superficie que envía tu producto solicita exactamente la misma variante por nombre y obtiene exactamente el mismo archivo predecible — sin detección de formato ni casos especiales por plataforma. El camino más rápido en la web es el componente <audiodn-player> con una clave Client-Side Player:

npm install @audiodn/components

<script type="module" src="https://unpkg.com/@audiodn/components@latest/dist/player.js"></script>

<script type="module">
  import '@audiodn/components/player';
</script>

<audiodn-player
  api-key="YOUR_PLAYER_API_KEY"
  scope="track"
  id="TRACK_ID"
  variants="aac"
  size="regular"
></audiodn-player>

Demo en vivo

La pista del hero de la homepage, reproducida aquí desde su única variante estandarizada aac.

Solicita la misma variante en cualquier lugar

El player es opcional. Aplicaciones web personalizadas, móviles, Flutter, nativas y de servidor pueden crear una play session y reproducir en streaming la URL firmada devuelta para la misma variante con nombre, o firmar URLs de entrega directamente para reproducción en el backend.

• Sitio web / player personalizado — incrusta <audiodn-player>, o solicita el archivo para tu propia UI. Consulta la guía de Integración web.

• App móvil — crea una play session solicitando la variante aac desde Swift, Kotlin o Flutter, y luego reproduce en streaming la URL firmada con cualquier player de audio de la plataforma. Consulta Integración móvil.

• Servidor / API — firma URLs de entrega para reproducción backend-to-backend o descargas. Consulta Entrega firmada y la API de variantes.

Más opciones del player (temas, tamaños, playlists, cover art): Documentación del componente Player.

Cuándo usar este flujo

Úsalo siempre que tu producto acepte audio que no controlas y necesite reproducirse de forma consistente. Eso cubre cargas de usuarios, artistas, teléfonos, navegadores, dispositivos de grabación, software de edición, sistemas externos y múltiples herramientas de producción a la vez.

Encaja en plataformas de música, podcasts, grabaciones de voz, audio social, productos educativos, marketplaces, apps de audio generado por IA y otros productos de audio generado por usuarios. En cada caso AudioDN puede sustituir la infraestructura personalizada que de otro modo operarías: almacenamiento de carga, colas de procesamiento, workers de FFmpeg, almacenamiento de salida, firma de entrega y entrega de reproducción.

Qué no cubre este ejemplo

Este ejemplo se centra en producir un formato de reproducción consistente a partir de cargas inconsistentes. Lo siguiente son capacidades relacionadas pero separadas, no parte de este flujo:

• Clips de vista previa — extractos cortos con seek restringido. Consulta Player de clip de vista previa.
• Waveforms — variantes de imagen o vídeo de waveform. Consulta Tipos de variantes.
• Variantes adicionales — bitrates o codecs extra junto a aac para entrega multi-calidad.
• Descargas sin pérdida — ofrecer descargas FLAC o WAV desde la misma carga.
• Normalización de loudness — AudioDN no realiza targeting de LUFS ni ajuste de ganancia; este flujo estandariza el formato, no el volumen.

FAQ

Lista de comprobación

• Existe una receta de variante de transcode aac a 128 kbps (configurada una vez en el dashboard, o añadida a una sola pista vía POST /v1/track/:track_id/variant).
• Un archivo de origen compatible se ha subido — vía la API o el componente <audiodn-uploader> — y ha alcanzado track_status_id ready.
• El player está acotado a la pista, solicitando la variante aac con una clave Client-Side Player.
• La misma variante aac se solicita de forma consistente en las integraciones web, móvil y de servidor.