# Subir pistas | Docs de AudioDN

> Elige quién crea la sesión de subida y si usas los componentes web AudioDN Uploader o (voice) Recorder o una interfaz web o nativa personalizada.

Source: https://audiodeliverynetwork.com/es/docs/integration/uploading/

---

# Subir pistas

Elige quién crea o autoriza la sesión de subida y — si tu servidor la crea — cómo se transfieren los archivos. La reproducción es una decisión aparte; consulta [Reproducir y acceder a pistas](/docs/integration/playback).

#### Ciclo de vida de subida por archivo

Una sesión de subida puede autorizar muchos archivos, pero cada archivo necesita su propia pista y URL de subida. Crea la sesión y, para cada archivo, llama a `POST /v1/upload/{upload_session_id}/track` y haz `PUT` de los bytes a `track_upload.upload_url`. Opcionalmente incluye un `track` anidado al crear la sesión para el primer archivo. Referencia completa: [Upload Sessions](/docs/api/upload-sessions).

## Subir tracks

Elige quién crea la upload session y luego — si hace falta — cómo se transfieren los archivos. Las elecciones de carga y reproducción son independientes.

¿Quién debe crear o autorizar la upload session?

 Seleccionado Componentes web AudioDN Uploader o (voice) Recorder La configuración más rápida. Componentes web con una Client-Side Upload key acotada; gestionan la creación de la sesión y la transferencia. El (voice) Recorder captura desde el micrófono. Seleccionado Tu navegador o aplicación nativa Una Client-Side Upload key acotada. Tu app crea la upload session y sube cada archivo a la URL proporcionada.  Seleccionado Tu servidor Una API Access key en tu servidor. Tu servidor aplica la autorización específica de la aplicación y crea una upload session de corta duración.

¿Cómo debe el usuario transferir los archivos?

 Seleccionado Componentes web AudioDN Uploader o (voice) Recorder Pasa la upload session creada en el servidor al componente web AudioDN Uploader o (voice) Recorder. Seleccionado Interfaz de carga personalizada en navegador o nativa Usa la información de carga proporcionada en tu propia UI de carga.

## AudioDN Uploader o (voice) Recorder (componentes web) con una Client-Side Upload key

Configuración más rápida. Una Client-Side Upload key con alcance; el componente crea la sesión y sube cada archivo.

1

#### Crear una Client-Side Upload key

En el [dashboard](https://account.audiodeliverynetwork.com) ve a **Settings → API Keys** y crea una clave **Client-Side Upload**. Opcionalmente limítala a una colección. Esta clave solo puede crear sesiones de subida — no leer ni eliminar pistas.

2

#### Instalar el componente web

```
npm install @audiodn/components
```

Uploader:

```
import '@audiodn/components/uploader'
```

O (voice) Recorder:

```
import '@audiodn/components/recorder'
```

Alternativas CDN:

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

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

3

#### Renderizar el componente web

```
<audiodn-uploader
  api-key="CLIENT-SIDE-UPLOAD-KEY"
  collection-id="COLLECTION-ID"
  accent-color="#ff00ff"
></audiodn-uploader>
```

```
<audiodn-recorder
  api-key="CLIENT-SIDE-UPLOAD-KEY"
  collection-id="COLLECTION-ID"
  accent-color="#ff00ff"
></audiodn-recorder>
```

Si la clave está limitada a una colección, puedes omitir `collection-id`. Nunca establezcas ambos `api-key` y `upload-session-id`.

4

#### Qué hace el componente web

Para cada archivo, el componente crea (o reutiliza) una sesión de subida, llama a `POST /v1/upload/:upload_session_id/track` y sube los bytes a `track_upload.upload_url`. Luego AudioDN procesa las variantes configuradas.

Opcional: configura un [webhook de track-processing](/docs/webhooks/track-processing) para saber cuándo una pista está lista.