Respuesta corta: a 9 de septiembre de 2026, la documentación canónica de la API de Gemini enumera dos IDs de Lyria 3.5: lyria-3.5-pro-preview para canciones completas y lyria-3.5-clip-preview para clips de 30 segundos. Los mismos IDs aparecen en la lista de modelos compatibles con la API Interactions. Para proyectos nuevos, la propia documentación de Google recomienda Interactions; generateContent sigue disponible, pero su documentación está marcada como Legacy.
Eso significa que la decisión principal no debería ser “un ID para generateContent y otro para Interactions”. Hoy, la ruta más segura es elegir primero el modelo (Pro o Clip) y después usar ese ID en la superficie de API que realmente llama el código. La confusión viene de ejemplos y páginas que se han actualizado a ritmos distintos, incluidos fragmentos Java que todavía muestran lyria-3-generate-001, aunque ese identificador no aparece en la lista canónica actual de modelos Lyria 3.5.
Qué ID usar hoy
| Objetivo | ID recomendado | Superficie | Duración y salida | Llamada mínima |
|---|---|---|---|---|
| Canción completa en un proyecto nuevo | lyria-3.5-pro-preview | Interactions | Algunos minutos, controlables mediante el prompt; MP3 por defecto y opción de WAV en Pro | client.interactions.create(model="lyria-3.5-pro-preview", input="...") |
| Clip, loop o vista previa rápida | lyria-3.5-clip-preview | Interactions | 30 segundos; MP3 | client.interactions.create(model="lyria-3.5-clip-preview", input="...") |
| Canción completa en código heredado | lyria-3.5-pro-preview | generateContent (Legacy) | Algunos minutos; MP3 por defecto y opción de WAV en Pro | POST /v1beta/models/lyria-3.5-pro-preview:generateContent |
| Clip en código heredado | lyria-3.5-clip-preview | generateContent (Legacy) | 30 segundos; MP3 | POST /v1beta/models/lyria-3.5-clip-preview:generateContent |
Las referencias más sólidas para los nombres son la página de Lyria 3.5 Pro Preview, la página de Lyria 3.5 Clip Preview y la descripción general de la API Interactions. Las notas de la versión de septiembre de 2026 también registran explícitamente los dos IDs.
Por qué parece que aparecen IDs diferentes
Google no ofrece, en la documentación revisada, una explicación formal de por qué algunos ejemplos muestran identificadores diferentes. Por lo tanto, atribuir la diferencia a una migración interna concreta sería especular. Lo que sí puede verificarse es que las páginas no están perfectamente sincronizadas.
La guía actual de generación de música usa la API Interactions y, en sus ejemplos de Python, JavaScript y REST, apunta a lyria-3.5-pro-preview y lyria-3.5-clip-preview. Sin embargo, algunos ejemplos Java de la misma página todavía muestran lyria-3-generate-001. Ese último ID no aparece en la tabla actual de modelos de Interactions ni en las páginas canónicas de Lyria 3.5. Por eso, no debería tratarse como el identificador predeterminado para copiar en un proyecto nuevo.
También pueden aparecer snapshots en caché o resultados de búsqueda con nombres como lyria-3.5. Si el código se creó a partir de una versión anterior de la documentación, conviene volver a consultar la página del modelo antes de asumir que ese nombre sigue siendo el recomendado. En APIs en vista previa, los alias y los ejemplos pueden cambiar; que un nombre aparezca en un fragmento antiguo no garantiza que siga siendo el identificador de referencia actual.
“Legacy” describe la API, no Lyria 3.5
La etiqueta Legacy en Gemini Generate Content API (Legacy) se refiere a la superficie generateContent. La guía de inicio de esa API indica que Google recomienda la nueva API Interactions para proyectos y aplicaciones nuevos.
Eso no convierte a lyria-3.5-pro-preview ni a lyria-3.5-clip-preview en modelos heredados. Al contrario: las notas de la versión del 3 de septiembre de 2026 presentan ambos como la generación Lyria 3.5 en vista previa pública. La página de descontinuaciones identifica lyria-3-pro-preview y lyria-3-clip-preview como la generación anterior y recomienda migrar a sus equivalentes 3.5.
Cómo cambia de lugar el mismo ID entre endpoints
En REST con generateContent, el ID forma parte de la ruta de la URL. Para una canción completa, la llamada tiene la forma /v1beta/models/lyria-3.5-pro-preview:generateContent. El cuerpo usa la estructura contents y parts.
En la API Interactions, el endpoint es genérico: /v1beta/interactions. El modelo va en el cuerpo de la solicitud, en el campo model, mientras que la entrada va en input. Por eso, una diferencia visual entre ejemplos no implica necesariamente un ID diferente; a menudo solo cambia el lugar donde se proporciona el mismo ID.
Ejemplo mínimo con Interactions
Python: interaction = client.interactions.create(model="lyria-3.5-pro-preview", input="Una pista instrumental cinematográfica de dos minutos.")
Para recuperar el resultado, los ejemplos actuales usan propiedades como interaction.output_audio e interaction.output_text. La respuesta también puede recorrerse mediante steps cuando la aplicación necesita controlar los bloques individuales de texto y audio.
Ejemplo mínimo con generateContent
REST: POST https://generativelanguage.googleapis.com/v1beta/models/lyria-3.5-pro-preview:generateContent
El cuerpo contiene contents, con la instrucción dentro de parts. En los SDK, el equivalente es llamar a client.models.generate_content o generateContent con el mismo ID del modelo.
Pro o Clip: la decisión que realmente cambia el comportamiento
Lyria 3.5 Clip Preview está pensado para clips cortos, loops y vistas previas y produce 30 segundos de audio estéreo a 44,1 kHz. Lyria 3.5 Pro Preview está optimizado para canciones completas con versos, estribillos y puentes y puede producir algunos minutos, con una duración influida por el prompt y las marcas de tiempo.
Ambos aceptan texto e imagen como entrada. La documentación de los modelos describe salida de audio MP3 y texto con letras. Para Pro, la guía también documenta la opción de solicitar WAV. Cambiar de Clip a Pro es, por tanto, un cambio funcional; cambiar solo de Interactions a generateContent es un cambio de superficie y de formato de solicitud/respuesta.
Cómo migrar sin arrastrar un ID incorrecto
- Identifica la superficie: busca client.interactions.create o el endpoint /v1beta/interactions; si aparece models/...:generateContent, estás en el flujo legacy.
- Elige Pro o Clip: usa lyria-3.5-pro-preview para canciones completas y lyria-3.5-clip-preview para una salida de 30 segundos.
- No migres cambiando solo el nombre del método: Interactions usa input y una respuesta basada en interaction/steps; generateContent usa contents y candidates/parts.
- Desconfía de IDs que aparecen en un solo snippet: antes de copiar lyria-3-generate-001, lyria-3.5 u otro nombre divergente, comprueba si aparece en la página canónica del modelo y en la lista actual de la API que vas a usar.
- Para un proyecto nuevo, prefiere Interactions: esa es la recomendación explícita de la guía de inicio de generateContent legacy.
Qué hacer si dos ejemplos oficiales se contradicen
Usa una jerarquía de confianza. Primero, consulta la página del modelo y la lista de modelos compatibles con la API. Después, revisa las notas de la versión y la página de descontinuaciones. Solo entonces utiliza un snippet específico de un lenguaje como fuente del ID.
Este orden es especialmente importante en una vista previa recién lanzada. A 9 de septiembre de 2026, las páginas canónicas y las notas de la versión convergen en lyria-3.5-pro-preview y lyria-3.5-clip-preview. La divergencia residual de algunos ejemplos debe tratarse como una inconsistencia documental, no como una regla según la cual Interactions y generateContent necesiten necesariamente nombres distintos.
En resumen: para código nuevo, usa Interactions con lyria-3.5-pro-preview o lyria-3.5-clip-preview. Para código existente en generateContent, esos mismos IDs 3.5 aparecen en la documentación legacy actual. Al migrar, cambia la estructura de la solicitud y de la respuesta junto con la superficie de API, y no copies un ID aislado de un ejemplo antiguo sin comprobarlo en la referencia del modelo.
