Suno est un service de génération musicale qui transforme une idée écrite en chansons. Le flux de travail automatique documenté accepte une courte description de la musique souhaitée et un réglage permettant de choisir une version instrumentale, puis génère deux morceaux. Utilisez le descriptif pour définir le thème, l’ambiance et l’orientation musicale que vous souhaitez entendre dans les pistes terminées.
Commencez par le rôle que la musique doit jouer. Un fond musical calme pour une explication, une ouverture énergique pour une courte vidéo ou une chanson méditative sur un voyage donnent chacun un objectif concret au descriptif. Décrivez en quelques phrases claires l’ambiance souhaitée et les caractéristiques musicales qui comptent pour cet objectif.
Pour une chanson chantée, précisez clairement le thème et la langue dans le descriptif créatif. Décrivez l’idée que le morceau doit exprimer et le ton que l’interprétation doit transmettre. Écoutez le résultat terminé pour évaluer la manière dont la voix, les paroles et l’arrangement fonctionnent ensemble. Conservez les informations générées sur la piste avec l’audio pour l’évaluation.
Pour un résultat instrumental, utilisez l’option de génération instrumentale décrite dans la documentation et décrivez l’orientation musicale dans le texte. Précisez l’atmosphère souhaitée et les instruments à mettre en avant lorsqu’ils comptent pour le projet. Évaluez le morceau terminé en fonction de la place qu’il occupera au montage, y compris les passages qui doivent accompagner une voix parlée en fond sonore ou soutenir une transition visuelle.
Le flux de travail automatique produit deux morceaux à partir de l’idée soumise. Traitez-les comme deux versions distinctes et conservez les deux fichiers audio terminés. Écoutez chacun du début à la fin, en passant par son développement. Évaluez les morceaux obtenus par rapport au même objectif, en tenant compte de leur ambiance, de leur arrangement et de leur adéquation à l’usage prévu.
La génération est organisée sous forme de tâche. Conservez l’ID de tâche renvoyé lorsque vous consultez son résultat et distinguez les pistes terminées des éléments encore en cours. Le résultat documenté comprend des informations propres à chaque piste, comme son titre, son statut, l’emplacement du fichier audio et sa durée. Enregistrez le fichier audio terminé lui-même avec les métadonnées disponibles et le descriptif d’origine.
Pour une vidéo ou une présentation, écoutez la musique sélectionnée avec le contenu réel. Vérifiez l’ouverture, les transitions et la fin au niveau d’écoute prévu. Marquez le passage qui sert le montage et conservez la piste entière pour les modifications ultérieures. La pertinence d’un extrait musical s’évalue dans le contexte de la voix, des images et du rythme de l’œuvre terminée.
Conservez ensemble l’idée écrite, le réglage de génération instrumentale, la sélection du modèle et toutes les pistes terminées. Lorsqu’une version doit être révisée, identifiez l’écart musical, par exemple un arrangement trop dense sous une voix parlée ou une ouverture qui se développe trop lentement. Préservez l’orientation utile et révisez la partie du descriptif liée à ce problème.
", "aboutText": "Suno est un service de génération musicale qui transforme une idée écrite en chansons. Le flux de travail automatique documenté accepte une courte description de la musique souhaitée et un réglage permettant de choisir une version instrumentale, puis génère deux morceaux. Utilisez le descriptif pour définir le thème, l’ambiance et l’orientation musicale que vous souhaitez entendre dans les pistes terminées.\n\nCommencez par le rôle que la musique doit jouer. Un fond musical calme pour une explication, une ouverture énergique pour une courte vidéo ou une chanson méditative sur un voyage donnent chacun un objectif concret au descriptif. Décrivez en quelques phrases claires l’ambiance souhaitée et les caractéristiques musicales qui comptent pour cet objectif.\n\nPour une chanson chantée, précisez clairement le thème et la langue dans le descriptif créatif. Décrivez l’idée que le morceau doit exprimer et le ton que l’interprétation doit transmettre. Écoutez le résultat terminé pour évaluer la manière dont la voix, les paroles et l’arrangement fonctionnent ensemble. Conservez les informations générées sur la piste avec l’audio pour l’évaluation.\n\nPour un résultat instrumental, utilisez l’option de génération instrumentale décrite dans la documentation et décrivez l’orientation musicale dans le texte. Précisez l’atmosphère souhaitée et les instruments à mettre en avant lorsqu’ils comptent pour le projet. Évaluez le morceau terminé en fonction de la place qu’il occupera au montage, y compris les passages qui doivent accompagner une voix parlée en fond sonore ou soutenir une transition visuelle.\n\nLe flux de travail automatique produit deux morceaux à partir de l’idée soumise. Traitez-les comme deux versions distinctes et conservez les deux fichiers audio terminés. Écoutez chacun du début à la fin, en passant par son développement. Évaluez les morceaux obtenus par rapport au même objectif, en tenant compte de leur ambiance, de leur arrangement et de leur adéquation à l’usage prévu.\n\nLa génération est organisée sous forme de tâche. Conservez l’ID de tâche renvoyé lorsque vous consultez son résultat et distinguez les pistes terminées des éléments encore en cours. Le résultat documenté comprend des informations propres à chaque piste, comme son titre, son statut, l’emplacement du fichier audio et sa durée. Enregistrez le fichier audio terminé lui-même avec les métadonnées disponibles et le descriptif d’origine.\n\nPour une vidéo ou une présentation, écoutez la musique sélectionnée avec le contenu réel. Vérifiez l’ouverture, les transitions et la fin au niveau d’écoute prévu. Marquez le passage qui sert le montage et conservez la piste entière pour les modifications ultérieures. La pertinence d’un extrait musical s’évalue dans le contexte de la voix, des images et du rythme de l’œuvre terminée.\n\nConservez ensemble l’idée écrite, le réglage de génération instrumentale, la sélection du modèle et toutes les pistes terminées. Lorsqu’une version doit être révisée, identifiez l’écart musical, par exemple un arrangement trop dense sous une voix parlée ou une ouverture qui se développe trop lentement. Préservez l’orientation utile et révisez la partie du descriptif liée à ce problème.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "704e2fd7075ce1c80e4e8c6e42eabc785fcea303079f4424c6fd283ef9489e77", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "suno-apiSuno crée de la musique à partir d’une idée écrite en quelques mots. Le flux de travail automatique documenté produit deux morceaux et propose une option de génération instrumentale; les fichiers audio terminés et les métadonnées des pistes sont renvoyés dans le cadre de la tâche de génération.
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.
Suno est un service de génération musicale qui transforme une idée écrite en chansons. Le flux de travail automatique documenté accepte une courte description de la musique souhaitée et un réglage permettant de choisir une version instrumentale, puis génère deux morceaux. Utilisez le descriptif pour définir le thème, l’ambiance et l’orientation musicale que vous souhaitez entendre dans les pistes terminées.
Commencez par le rôle que la musique doit jouer. Un fond musical calme pour une explication, une ouverture énergique pour une courte vidéo ou une chanson méditative sur un voyage donnent chacun un objectif concret au descriptif. Décrivez en quelques phrases claires l’ambiance souhaitée et les caractéristiques musicales qui comptent pour cet objectif.
Pour une chanson chantée, précisez clairement le thème et la langue dans le descriptif créatif. Décrivez l’idée que le morceau doit exprimer et le ton que l’interprétation doit transmettre. Écoutez le résultat terminé pour évaluer la manière dont la voix, les paroles et l’arrangement fonctionnent ensemble. Conservez les informations générées sur la piste avec l’audio pour l’évaluation.
Pour un résultat instrumental, utilisez l’option de génération instrumentale décrite dans la documentation et décrivez l’orientation musicale dans le texte. Précisez l’atmosphère souhaitée et les instruments à mettre en avant lorsqu’ils comptent pour le projet. Évaluez le morceau terminé en fonction de la place qu’il occupera au montage, y compris les passages qui doivent accompagner une voix parlée en fond sonore ou soutenir une transition visuelle.
Le flux de travail automatique produit deux morceaux à partir de l’idée soumise. Traitez-les comme deux versions distinctes et conservez les deux fichiers audio terminés. Écoutez chacun du début à la fin, en passant par son développement. Évaluez les morceaux obtenus par rapport au même objectif, en tenant compte de leur ambiance, de leur arrangement et de leur adéquation à l’usage prévu.
La génération est organisée sous forme de tâche. Conservez l’ID de tâche renvoyé lorsque vous consultez son résultat et distinguez les pistes terminées des éléments encore en cours. Le résultat documenté comprend des informations propres à chaque piste, comme son titre, son statut, l’emplacement du fichier audio et sa durée. Enregistrez le fichier audio terminé lui-même avec les métadonnées disponibles et le descriptif d’origine.
Pour une vidéo ou une présentation, écoutez la musique sélectionnée avec le contenu réel. Vérifiez l’ouverture, les transitions et la fin au niveau d’écoute prévu. Marquez le passage qui sert le montage et conservez la piste entière pour les modifications ultérieures. La pertinence d’un extrait musical s’évalue dans le contexte de la voix, des images et du rythme de l’œuvre terminée.
Conservez ensemble l’idée écrite, le réglage de génération instrumentale, la sélection du modèle et toutes les pistes terminées. Lorsqu’une version doit être révisée, identifiez l’écart musical, par exemple un arrangement trop dense sous une voix parlée ou une ouverture qui se développe trop lentement. Préservez l’orientation utile et révisez la partie du descriptif liée à ce problème.
POST /v1/music/generationstextaudio, image, video| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites suno-api Conditions: Utilisez exactement ce sélecteur de routage Ailoot. | Par défaut— |
Champgpt_description_prompt | Typestring | ExigenceObligatoire | Valeurs et limites Conditions: Décrivez l’idée musicale ou le thème de la chanson. | Par défaut— |
Champmv | Typestring | ExigenceObligatoire | Valeurs et limites chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Conditions: Sélectionnez explicitement une version documentée de Suno ; l’exemple utilise chirp-crow (v5). | Par défaut— |
Champmake_instrumental | Typeboolean | ExigenceObligatoire | Valeurs et limites Conditions: Définissez true pour une musique instrumentale ou false pour une chanson. | Par défaut— |
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, gpt_description_prompt, mv, make_instrumental |
Paramètreoptional | Contrat |
Paramètrematerial_types | Contrattext |
Paramètreconditions | ContratUtilisez exactement ce sélecteur de routage Ailoot., Décrivez l’idée musicale ou le thème de la chanson., Sélectionnez explicitement une version documentée de Suno ; l’exemple utilise chirp-crow (v5)., Définissez true pour une musique instrumentale ou false pour une chanson. |
Cycle de vie : submit_once_poll_original
GET /v1/music/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Quantité facturée | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Quantité facturée— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationPar requête | Barème tarifaire— | Quantité prévisionnelle— | Quantité facturéeune requête | Coût Entrée · Estimation à des fins de comparaison uniquement $0.2 par requête |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Quantité facturée— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.2 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
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}"\ncat > request.json <<'JSON'\n{\n "model": "suno-api",\n "gpt_description_prompt": "古诗词",\n "mv": "chirp-crow",\n "make_instrumental": false\n}\nJSON\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\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\\x89PNG\\r\\n\\x1a\\n" else "jpg" if raw[:3]==b"\\xff\\xd8\\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nTéléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/music/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez la réponse complète et les en-têtes, les identifiants d’origine, chaque résultat réel et tous les champs de consommation et de comptabilisation. Enregistrez chaque ressource unique dont vous êtes propriétaire et conservez tous les rôles qui y font référence.
Conservez l’identifiant public id de la tâche ou de l’opération renvoyée, ainsi que tous les en-têtes. Consultez uniquement la tâche d’origine ; unknown ou result_pending_check n’autorise pas une nouvelle création.
| Champ | Type |
|---|---|
Champid | Typestring |
Champpolling_url | Typestring |
Champprovider_task_id | Typestring |
Champdata.task_id | Typestring |
Champdata.status | Typestring |
Champdata.data[].audio_url | Typestring |
Champdata.data[].image_url | Typestring |
Champdata.data[].image_large_url | Typestring |
Champdata.data[].video_url | Typestring |
Ailoot Ultra suno-api
Utilisez les chemins de méthode indiqués ci-dessus.