---
name: auroflow-audio-production
description: Producir locución, preparar canciones y mezclar voz, música y sonido propio mediante la API y el MCP público de Auroflow. Usar para piezas de audio y bandas sonoras con fuentes separadas, costes comprobados y recuperación por ID, y para comparar voces de Google Vids y generar locuciones independientes; la voz ligada de un Character conserva su recorrido de Flow.
---

# Producción de audio en Auroflow

Conservar por separado el texto y trabajo de narración, la canción o archivo
musical y la intención de mezcla. Cambiar un volumen no requiere sintetizar otra
voz ni otra canción. Una mezcla terminada tampoco demuestra que sus palabras,
acento o balance sean correctos: escuchar la entrega completa y su SHA actual.

## Descubrir el contrato de esta instancia

Conectar a `https://api.auroflow.club/v1/mcp` con la credencial propia del usuario,
preparada en [Conectar agente](https://auroflow.club/conectar). Mantener el
Bearer en el almacén privado del cliente; no enviarlo en prompts, URLs o
recibos. Las lecturas, escrituras y descargas comprueban propietario. El agente
no necesita cookies, documentos nativos, rutas ni Chrome del servidor.

Después de `initialize`, consultar `tools/list` con
`_meta:{"auroflow/toolset":"audio"}`: reúne 14 herramientas de narración,
música, fuentes y mezcla, sin exigir el bootstrap de películas. `full` reúne
todos los recorridos y `editing` contiene el acabado de vídeo. Leer
`auroflow_capabilities {area:"production"}` y los bloqueos vivos. Una operación
implementada, una autorización incluida y un ensayo histórico no acreditan
disponibilidad actual. Si una herramienta no está anunciada, no inventar su
payload ni continuar por una interfaz privada.

`auroflow_queue {}` muestra también narraciones, música y medios nativos
propios en `queue.auxiliary_items`, con contadores `auxiliary_pending` y
`auxiliary_attention_required`. Estas actividades no tienen posición ni ETA
confirmadas. `waiting_for_worker` conserva una espera de causa aún desconocida;
`waiting_native_turn` indica que otro recorrido conserva el recurso compartido.
La lectura no inicia, recupera ni repite trabajos. Una cola Flow vacía no prueba
que una locución haya terminado: consulta siempre el mismo `tts-…`.

## Elegir el recorrido y el presupuesto

- **Locución independiente:** `auroflow_capabilities {area:"vids_voices"}` →
  `auroflow_plan_narration` → `auroflow_generate_narration_zero` →
  `auroflow_get`. Exigir coste vivo de narración exactamente cero en
  dinero, Auro y Google. El plan no es una cotización ni una autorización.
  Galería, elección de voz y opción de español de España:
  [voces de Vids](references/vids-voices.md).
- **Canción o instrumental nuevo:** descubrir el proveedor y contrato
  anunciado. `auroflow_plan_music` → `auroflow_generate_music_zero` →
  `auroflow_get` es la ruta Vids, con control vivo de coste0; Flow Music
  puede consumir créditos incluidos sin pago adicional, que no equivalen a
  «0 créditos». La presencia de una fuente `music` no activa ninguno. Mientras
  falten precio o recogida verificable, mantener el bloqueo; no cambiar de
  proveedor ni usar un botón privado como sustituto del MCP.
- **Música o sonido ya propios:** `auroflow_upload_audio` y
  `auroflow_list {kind:"sources"}`. Subir un archivo no lo sintetiza ni acredita coste
  cero de su creación anterior.
- **WAV mezclado:** si están anunciadas, `auroflow_plan_audio_mix` →
  `auroflow_create_audio_mix` → `auroflow_get`; consultar
  `auroflow_list {kind:"audio_mix_queue"}` durante la espera. La mezcla determinista no genera
  voz ni música. Su coste cero excluye la creación previa de las fuentes.
- **Banda sonora sobre vídeo:** usar las capas de audio de una pista gráfica y
  su exportación `motion-…`. No suponer que un `mix-…` se acepta directamente
  como fuente de vídeo; leer [el contrato](references/audio-contract.md).

## Conservar intención, identidad y recuperación

Elegir la voz por descripción y muestras observadas. `vids-holt` se describió
como «Tono grave e informativo»; volver a descubrirlo antes de usarlo. El nombre
no prueba género o región. Una voz Vids `vids-…` no sustituye el UUID de la voz
ligada de un Character. Para español hablado conservar el literal y los saltos
LF; no añadir etiquetas regionales por defecto.

Persistir el request exacto y un ID nuevo antes de cada escritura:
`tts-…` para narración, `mix-…` para mezcla y, cuando se anuncie su generación,
`mus-…` para música Vids; guardar los IDs devueltos para las fuentes `aud_…`.
Conservar propietario, revisión, SHA, tiempos y recibos. No
introducir `account_ref`, rutas o URLs nativas como fuentes del cliente.

Tras incertidumbre leer el **mismo ID**. `auroflow_recover` recoge la
síntesis original y no la vuelve a enviar. Si falló antes del primer envío,
`auroflow_recover {action:"resume_preparation", id,cost_max:0}` permite retomar la misma
preparación ya autorizada sólo tras prueba nativa de petición, voz, cuenta,
documento y ausencia de submit/ack/incertidumbre. Puede llegar al primer envío;
no es collect-only. Una respuesta `queued` aún no prueba que se haya enviado.
No crear otro `tts-…` ni cambiar el literal o la voz para sortear un fallo.
`auroflow_recover`
recupera la misma composición local con sus fuentes fijadas; no crea medios
del proveedor. `auroflow_recover` sólo recoge la canción ya enviada.
Si el primer intento quedó antes del envío, leer el mismo trabajo y usar
`auroflow_recover {action:"resume_preparation", id,cost_max:0}` sólo cuando las pruebas
nativas demuestren la misma petición y una preparación aún no enviada. Esta
operación puede retomar la preparación autorizada para su primer envío;
rechaza la existencia o incertidumbre de un envío anterior. No cambia texto,
opciones o ID. `auroflow_list {kind:"music"}` permite retomar los trabajos propios.
Un conflicto de intención exige leer, no sobrescribir.

Consultar `features.vids_music` en las capacidades. En Vids se observó
**Lyria 3 para `clip`** y **Lyria 3.5 para `full_song`**. El modo corto apunta
a unos30 s y la canción completa a unos180 s, sin duración
exacta garantizada. La API puede anunciar los tools mientras el adaptador
permanece deshabilitado hasta verificar driver y colector nativos. El plan
no lo activa ni prueba el precio. Flow Music continúa como proveedor distinto.

La autorización del encargo permite usar `approved:true` donde el esquema lo
exige; no pedir otra aprobación por un plan. No inventar una autorización ni
una escucha. Conservar cualquier coste desconocido o positivo como bloqueo del
recorrido que exige cero.

## Mezclar y revisar

Descubrir fuentes propias terminadas y comprobar duración real antes de fijar
el montaje. Hasta ocho capas permiten posición, recorte, volumen, fundidos y
silencio, a velocidad original. No hay ducking, normalización, loop o
estiramiento automáticos. Las capas silenciadas también se verifican; una
mezcla vacía es silencio. Un tramo corto se completa con silencio, no con voz
prolongada. Preservar el final de cada palabra y las colas musicales.

Una canción Vids propia terminada se referencia como `source.kind:"music"`
con su `mus-…` y variante1. El servidor verifica su WAV directamente; no hay
que volver a subirlo ni regenerarlo por superar 10 MiB. Esta ruta es API/MCP:
no atribuir al selector web soporte de Music que no se haya comprobado.

Verificar el WAV final y escuchar todo: texto literal, pronunciación, entradas
y salidas, clipping audible, voz tapada por canto o música, silencios y cortes.
Separar verificación técnica, revisión perceptual y aprobación humana. ASR no
certifica identidad, timbre o acento regional. Si no se pudo escuchar, indicarlo
y conservar la revisión pendiente, sin cambiar fuentes por una conjetura.

Leer [audio-contract.md](references/audio-contract.md) para herramientas,
payloads, envelopes y recuperación. Leer [song-and-narration.md](references/song-and-narration.md)
para un ejemplo original de canción y locución grave en español; sus tiempos
son decisiones editoriales que deben ajustarse al audio observado.
