google/lyria crée de la musique depuis un prompt écrit via /v1/music/generations. Demandez par exemple un fond instrumental sobre pour une démonstration produit, en précisant instruments principaux et place laissée à la narration. Choisissez-le pour obtenir un extrait musical généré.
model et prompt sont obligatoires. n ou count accepte un à huit extraits et la méthode retourne le résultat synchroniquement. Gardez chaque extrait et ses métadonnées réelles. Ni référence audio, durée ni tempo ne sont des réglages exposés. Décrivez l’intention musicale sans la prendre pour une propriété mesurée garantie du résultat.
", "aboutText": "google/lyria crée de la musique depuis un prompt écrit via /v1/music/generations. Demandez par exemple un fond instrumental sobre pour une démonstration produit, en précisant instruments principaux et place laissée à la narration. Choisissez-le pour obtenir un extrait musical généré. model et prompt sont obligatoires. n ou count accepte un à huit extraits et la méthode retourne le résultat synchroniquement. Gardez chaque extrait et ses métadonnées réelles. Ni référence audio, durée ni tempo ne sont des réglages exposés. Décrivez l’intention musicale sans la prendre pour une propriété mesurée garantie du résultat.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria crée de la musique depuis un prompt écrit via /v1/music/generations. Demandez par exemple un fond instrumental sobre pour une démonstration produit, en précisant instruments principaux et place laissée à la narration. Choisissez-le pour obtenir un extrait musical généré.
model et prompt sont obligatoires. n ou count accepte un à huit extraits et la méthode retourne le résultat synchroniquement. Gardez chaque extrait et ses métadonnées réelles. Ni référence audio, durée ni tempo ne sont des réglages exposés. Décrivez l’intention musicale sans la prendre pour une propriété mesurée garantie du résultat.
", "short_text": "Génération texte-vers-musique de un à huit extraits demandés, avec réponse synchrone." }, "copy_sha256": "b755d66bd8f8898dd0b781220263c785a352ff79fbd94ba3f612745c33adcef7", "copy_source": { "locale": "fr-ca", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "d2ef1ed1a21ef24c9da900c47fbe6c1f5bca319d0e96bcc038692b2307a6df3e", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "2afd12501629f5be2a25aab05f4e59d30c840f025d0281d47eb58ee68ae43776", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ca", "methods": [ { "html": "google/lyriaGénération texte-vers-musique de un à huit extraits demandés, avec réponse synchrone.
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.
google/lyria crée de la musique depuis un prompt écrit via /v1/music/generations. Demandez par exemple un fond instrumental sobre pour une démonstration produit, en précisant instruments principaux et place laissée à la narration. Choisissez-le pour obtenir un extrait musical généré.
model et prompt sont obligatoires. n ou count accepte un à huit extraits et la méthode retourne le résultat synchroniquement. Gardez chaque extrait et ses métadonnées réelles. Ni référence audio, durée ni tempo ne sont des réglages exposés. Décrivez l’intention musicale sans la prendre pour une propriété mesurée garantie du résultat.
POST /v1/music/generationstextmusic| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites google/lyria | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 8 | Par défaut1 |
Champcount | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 8 Conditions: Si n est aussi fourni, le nombre doit correspondre | Par défaut— |
text_to_music · Obligatoire : prompt
| 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 ID sont exacts ; la capacité du fournisseur est distincte de l’admission des requêtes.
POST /v1/music/generationsClips livrés × tarif de base par clip. Le tarif indicatif par requête ne s’ajoute pas. Exemples avant ajustements applicables.
1 × 0,08 USD = 0,08 USD
4 × 0,08 USD = 0,32 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/lyria", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nexport AILOOT_API_KEY\npython3 - <<'PY_RESULT'\nimport json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin, urlparse\nresult=json.loads(Path("result.json").read_text(encoding="utf-8"))\nprint(json.dumps(result,ensure_ascii=False,indent=2))\nfor number,clip in enumerate(result.get("data") or []):\n u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))\n if u.scheme!="https" or not u.hostname or u.username or u.password:\n raise SystemExit("Result URL must be HTTPS without embedded credentials")\n owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n raw=subprocess.check_output(args)\n 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"\n f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)\n print("Saved",f,clip.get("asset_id"))\n\nPY_RESULT\nextraits audio complets appartenant à votre compte / liens JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Enregistrez ou récupérez chaque extrait retourné et conservez l’identifiant réel, le type MIME et les métadonnées. La méthode est synchrone; aucune URL Ailoot distincte d’interrogation de génération musicale n’est ajoutée.
Si un résultat musical exige une vérification, conservez les valeurs operation_id/X-Client-Request-ID d’origine et les renseignements des extraits retournés. Récupérez les extraits existants appartenant à votre compte dans la bibliothèque média en utilisant les valeurs task_id ou asset_id réelles. Ne soumettez pas de nouveau la demande musicale et ne construisez pas d’URL d’interrogation de génération à partir de operation_id.
| Champ | Type |
|---|---|
Champmodel | Typestring |
Champresponse_id | Typestring |
Champdata[] | Typeowned clip record |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des éléments fournis ou valeur de paramètre invalides | É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. |
Ailoot google/lyria
Utilisez les chemins de méthode indiqués ci-dessus.