Lyria 3 Clip Preview
Lyria 3 Clip Preview est le modèle musical de Google pour les extraits courts, les boucles et les aperçus. Il s’inspire de texte ou d’images et produit 30 secondes de musique avec un audio stéréo à 48 kHz, en prenant en charge le chant, les paroles synchronisées et les arrangements instrumentaux.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Lyria 3 Clip Preview est le profil de génération musicale de Google pour les extraits courts, les boucles et les aperçus. Il accepte un prompt textuel ou une image d’inspiration et renvoie du texte et de l’audio. Le profil publié décrit des extraits de 30 secondes avec un audio stéréo à 48 kHz, comprenant du chant, des paroles synchronisées et des arrangements instrumentaux complets.
Décrire le moment musical
Nommez l’objectif de l’extrait et l’ambiance qu’il doit porter. Un court thème d’ouverture peut préciser une introduction sobre et une arrivée clairement marquée ; une ambiance de fond peut identifier le rythme et la texture nécessaires sous une scène visuelle. Indiquez si le résultat doit comporter du chant ou être instrumental et nommez les éléments musicaux importants pour le cahier des charges.
Gardez une structure assez courte pour l’extrait. Identifiez l’ouverture, la phrase principale et la fin ou le point de boucle. Si les mots importent, fournissez l’idée de paroles ou la formulation visée et examinez le résultat réellement chanté. Le cahier des charges musical doit distinguer le contenu vocal des indications concernant l’arrangement.
Inspiration par l’image et arrangement
Lorsque vous fournissez une image, expliquez la scène ou l’ambiance qu’elle apporte à la demande musicale. Un paysage calme et une scène nocturne bondée suggèrent des directions différentes, mais le rôle émotionnel souhaité doit rester explicite dans le texte. Gardez l’image avec le prompt lorsque vous comparez l’extrait renvoyé au concept visé.
Vérifiez l’équilibre entre le chant, les instruments et la phrase musicale principale. Pour une boucle, écoutez ensemble la fin et le début ; pour un aperçu, vérifiez si la courte durée communique la direction souhaitée. Un extrait accompagnant un montage doit être vérifié avec ce montage, plutôt qu’uniquement de manière isolée.
Conserver l’artefact à écouter
Sauvegardez l’audio réel et tout texte d’accompagnement avec le cahier des charges. Examinez les propriétés de son fichier lorsque vous préparez la lecture ou l’importation dans un éditeur et préservez toute information de paroles ou de synchronisation renvoyée par la requête. La musique est la sortie du modèle ; les coupes, les titres, les transitions visuelles et le mixage final de production peuvent être organisés autour de cet élément vérifié.
Ce profil Clip Preview exact convient à un livrable musical compact. Gardez son rôle de format court distinct lorsque vous prévoyez une composition plus longue et choisissez l’extrait renvoyé en écoutant la phrase complète, les mots chantés et la fin.
Ailoot · Musique POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewPremiers pas
Lyria 3 Clip Preview est le modèle musical de Google pour les extraits courts, les boucles et les aperçus. Il s’inspire de texte ou d’images et produit 30 secondes de musique avec un audio stéréo à 48 kHz, en prenant en charge le chant, les paroles synchronisées et les arrangements instrumentaux.
- Entrées acceptées
- Texte
- Résultats
- music
Disponible dans Ailoot · entrées et méthodes
Ailoot · Musique POST /v1/music/generations
- Entrée
text- Sortie
music- Format de sortie
- extraits audio complets dont vous êtes propriétaire / liens JSON
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites google/lyria-3-clip-preview | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Combinaisons d’éléments d’entrée
text_to_music · Obligatoire : prompt
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext |
Paramètrerequired | Contratnull |
Paramètreoptional_controls | Contratnull |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
Tarifs
Tarifs des méthodes Ailoot
POST /v1/music/generations- Sortie
- 0.04 USD par clip
- Référence uniquement · non ajouté
- 0.04 USD par requête
Clips livrés × tarif de base par clip. Le tarif indicatif par requête ne s’ajoute pas. Exemples avant ajustements applicables.
1 × 0.04 USD = 0.04 USD
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Détails du tarif de référence
Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.
Barèmes de référence du modèle
Prix par configuration
| Configuration | Niveau de service | Condition de contexte | Coût |
|---|---|---|---|
| ConfigurationUltra | Niveau de servicestandard | Condition de contexte{} | Coût Sortie · musique 0.08 USD par chanson |
Exemples de requêtes
Ailoot · Musique
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
if u.scheme!="https" or not u.hostname or u.username or u.password:
raise SystemExit("Result URL must be HTTPS without embedded credentials")
owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
raw=subprocess.check_output(args)
ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\xff" else "bin"
f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
print("Saved",f,clip.get("asset_id"))
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot · Musique
extraits audio complets dont vous êtes propriétaire / liens JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Enregistrez ou récupérez chaque extrait renvoyé et conservez son identifiant réel, son type MIME et ses métadonnées. La méthode est synchrone ; aucune URL distincte de consultation périodique de génération musicale Ailoot n’est introduite.
Si la réponse d’origine doit être vérifiée
Si un résultat musical nécessite une vérification, conservez les valeurs d’origine operation_id/X-Client-Request-ID et les informations sur les extraits renvoyés. Récupérez les extraits existants dont vous êtes propriétaire dans la médiathèque, à l’aide des valeurs réelles task_id ou asset_id. Ne renvoyez pas la demande musicale et ne construisez pas d’URL de consultation périodique de génération à partir de operation_id.
Champs de la réponse
| Champ | Type |
|---|---|
Champmodel | Typestring |
Champresponse_id | Typestring |
Champdata[] | Typeowned clip record |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Alias
Alias du modèle
Ailoot google/lyria-3-clip-preview
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Lyria 3 Clip Preview
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- Quels champs la requête utilise-t-elle ?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt