Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Aucune sortie pour le moment. Envoyez le formulaire pour générer du contenu.
Explorez différents cas d'utilisation et configurations de paramètres
Tarifs transparents sans frais cachés. Payez à l'utilisation.
| Règle & Modalité | Channel | Crédits | Prix (USD) | Prix officiel / référence | Économie quotidienne |
|---|---|---|---|---|---|
Suno timestamped-lyrics musicSuno | Starter | 1per run | $0.005 | - | - |
Guide complet d'utilisation de Suno
Récupérez des paroles horodatées pour un affichage synchronisé pendant la lecture audio. Idéal pour afficher des paroles façon karaoké dans les interfaces de lecteurs musicaux.
L’API Suno Timestamped Lyrics fournit des données de paroles synchronisées pour les morceaux de musique générés. Chaque ligne de paroles inclut des informations d’horodatage précises en secondes, permettant aux développeurs de créer des affichages façon karaoké, des fonctionnalités de synchronisation des paroles et des expériences de lecture musicale améliorées. L’API renvoie également des données de forme d’onde pour la visualisation audio, ce qui la rend idéale pour créer des interfaces complètes de lecteurs musicaux combinant affichage des paroles et représentation visuelle de l’audio.
L’API Suno Timestamped Lyrics fournit des paroles avec des valeurs d’horodatage exactes en secondes, garantissant une synchronisation parfaite entre l’affichage du texte et la lecture audio. Chaque ligne de paroles est minutée avec précision pour correspondre à la piste audio.
En plus des paroles horodatées, l’API renvoie des tableaux de données de forme d’onde pouvant être utilisés pour la visualisation audio. Cela permet aux développeurs de créer des interfaces de lecteurs musicaux riches et interactives avec une représentation visuelle de l’audio.
La sortie de l’API est optimisée pour les applications de type karaoké. Grâce à un minutage précis et à un texte de paroles complet, les développeurs peuvent facilement mettre en œuvre des fonctionnalités de surlignage au fil du chant et des affichages de paroles défilantes.
Créez un compte et obtenez votre clé API Suno Timestamped Lyrics. Cette clé authentifie toutes les requêtes et associe l’utilisation à votre compte.
Commencez par utiliser l’API de génération musicale Suno pour créer votre piste audio. Enregistrez le taskId et le audioId depuis la réponse de génération : vous en aurez besoin pour récupérer les paroles horodatées.
Appelez l’API Timestamped Lyrics avec votre taskId et votre audioId. L’API renverra des données de paroles synchronisées avec des horodatages précis et des informations de forme d’onde.
Utilisez les données horodatées pour créer des affichages de paroles synchronisées dans votre application. Associez-les aux données de forme d’onde pour obtenir des effets visuels améliorés.
L’API nécessite les paramètres taskId et audioId. Le taskId identifie la session de génération, tandis que audioId précise la piste exacte au sein de cette session.
Toutes les valeurs d’horodatage sont fournies en secondes sous forme de nombres à virgule flottante. Cela permet une synchronisation précise jusqu’à la milliseconde lorsque nécessaire.
Pour les pistes générées avec instrumental=true, aucune donnée de paroles ne sera disponible. L’API renverra tout de même les informations de forme d’onde et de durée.
Intégrez des paroles synchronisées dans des applications de lecteurs musicaux, afin de permettre aux utilisateurs de suivre la chanson en temps réel avec un texte surligné correspondant à la lecture audio.
Créez des fonctionnalités de karaoké avec un minutage précis des paroles, permettant aux utilisateurs de chanter avec des repères visuels qui mettent en évidence les paroles exactement au bon moment.
Créez des applications pédagogiques qui aident les utilisateurs à apprendre les paroles des chansons, à comprendre leur structure et à travailler le rythme grâce à un affichage de texte synchronisé avec précision.
Améliorez les fonctionnalités de partage musical sur les plateformes sociales en affichant des paroles synchronisées en même temps que la lecture audio, pour créer des expériences de contenu plus engageantes.
apipass.dev propose une tarification rentable pour l’accès à l’API Suno Timestamped Lyrics, la rendant accessible aux projets de toutes tailles, des développeurs individuels aux applications à grande échelle.
Une documentation API claire et détaillée, avec des exemples de code et des guides d’intégration, aide les développeurs à implémenter rapidement la fonctionnalité de paroles horodatées dans leurs applications.
Un support technique disponible en continu garantit que vos fonctionnalités de synchronisation des paroles restent opérationnelles, avec une assistance experte disponible chaque fois que vous en avez besoin.
Toutes les API nécessitent une authentification via un token Bearer.
Authorization: Bearer
Utilisez le SDK pour créer des tâches, conserver la taskId renvoyée et récupérer les résultats de Suno.
Installez @apipass-dev/apipass-sdk avant d'exécuter ces exemples SDK.
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkConservez votre clé API dans des variables d'environnement côté serveur. Le SDK l'envoie automatiquement comme token Bearer et ajoute les en-têtes JSON.
client.jobs.createTaskRécupérez des paroles horodatées pour un affichage synchronisé pendant la lecture audio
Utilisez cet exemple pour démarrer rapidement avec le SDK sélectionné.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/timestamped-lyrics",
9 "input": {
10 "taskId": "task_xxx",
11 "audioId": "audio_xxx"
12 }
13});
14
15console.log(task.data.taskId);L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}modelRequisstringLe nom du modèle à utiliser pour récupérer les paroles horodatées
"suno/timestamped-lyrics"
channelOptionnelstringVous pouvez spécifier le fournisseur correspondant au sein d’APIPASS via le paramètre channel ; ces fournisseurs prennent en charge les tâches réelles de génération d’images et de vidéos. APIPASS propose actuellement trois options de fournisseur :
La valeur par défaut du paramètre channel est auto. Lorsqu’elle est activée, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des tarifs en temps réel et des indicateurs de stabilité, afin d’équilibrer coût minimal et performances fiables. Conservez la valeur par défaut auto, sauf si vous avez des exigences de routage personnalisées.
Options disponibles :
auto
L’objet input contient les paramètres suivants, basés sur la configuration du formulaire :
input.taskIdRequisstringLe taskId ApiPass renvoyé par un précédent appel createTask suno/generate ou suno/extend. Ne transmettez pas l’ID de tâche du fournisseur amont NextMusic.
Champ obligatoire, longueur maximale : 100 caractères
"task_12345678"
input.audioIdRequisstringL’ID audio provenant de l’élément de résultat de la tâche source terminée.
Champ obligatoire, longueur maximale : 100 caractères
"audio_abc123xyz"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}codeCode d’état, 200 en cas de réussite, autres valeurs en cas d’échec
messageMessage de réponse, description de l’erreur en cas d’échec
data.lyricsTableau d’objets de paroles, chacun contenant un horodatage (en secondes) et du texte
data.lyrics[].timestampValeur d’horodatage en secondes indiquant quand cette ligne de paroles doit être affichée
data.lyrics[].textLe texte des paroles à afficher à l’horodatage spécifié
data.waveformTableau de données de forme d’onde pour la visualisation audio
data.durationDurée totale de la piste audio en secondes
client.jobs.recordInfoInterrogez l’état de la tâche de génération de reprise et récupérez les résultats
Utilisez cet exemple pour démarrer rapidement avec le SDK sélectionné.
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("<taskId>");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_cover_abc123",
5 "state": "success",
6 "resultJson": {
7 "data": {
8 "lyrics": [
9 {
10 "text": "Verse 1 starts here",
11 "timestamp": 0
12 },
13 {
14 "text": "With lyrics synchronized",
15 "timestamp": 3.5
16 },
17 {
18 "text": "To the audio playback",
19 "timestamp": 7.2
20 }
21 ],
22 "duration": 180.5,
23 "waveform": [
24 0.1,
25 0.3,
26 0.5,
27 0.8,
28 0.6,
29 0.4,
30 0.2
31 ]
32 }
33 }
34 }
35}data.stateÉtat actuel : queuing, generating, success ou fail
data.resultJson.dataTableau des versions de reprise générées avec URL et métadonnées
La page API montre le schéma des paramètres, mais Suno a également plusieurs combinaisons de modes spécifiques aux entreprises et des règles de rappel qui sont faciles à manquer.
Toutes les API nécessitent une authentification via un token Bearer.
Authorization: Bearer
Récupérez des paroles horodatées pour un affichage synchronisé pendant la lecture audio
L’API accepte une charge utile JSON avec la structure suivante :
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}modelRequisstringLe nom du modèle à utiliser pour récupérer les paroles horodatées
"suno/timestamped-lyrics"
channelOptionnelstringVous pouvez spécifier le fournisseur correspondant au sein d’APIPASS via le paramètre channel ; ces fournisseurs prennent en charge les tâches réelles de génération d’images et de vidéos. APIPASS propose actuellement trois options de fournisseur :
La valeur par défaut du paramètre channel est auto. Lorsqu’elle est activée, APIPASS répartit automatiquement les tâches entre les fournisseurs disponibles en fonction des tarifs en temps réel et des indicateurs de stabilité, afin d’équilibrer coût minimal et performances fiables. Conservez la valeur par défaut auto, sauf si vous avez des exigences de routage personnalisées.
Options disponibles :
auto
L’objet input contient les paramètres suivants, basés sur la configuration du formulaire :
input.taskIdRequisstringLe taskId ApiPass renvoyé par un précédent appel createTask suno/generate ou suno/extend. Ne transmettez pas l’ID de tâche du fournisseur amont NextMusic.
Champ obligatoire, longueur maximale : 100 caractères
"task_12345678"
input.audioIdRequisstringL’ID audio provenant de l’élément de résultat de la tâche source terminée.
Champ obligatoire, longueur maximale : 100 caractères
"audio_abc123xyz"
1curl -X POST "https://api.apipass.dev/api/v1/generate/get-timestamped-lyrics" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/timestamped-lyrics",
6 "input": {
7 "taskId": "task_xxx",
8 "audioId": "audio_xxx"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}codeCode d’état, 200 en cas de réussite, autres valeurs en cas d’échec
messageMessage de réponse, description de l’erreur en cas d’échec
data.lyricsTableau d’objets de paroles, chacun contenant un horodatage (en secondes) et du texte
data.lyrics[].timestampValeur d’horodatage en secondes indiquant quand cette ligne de paroles doit être affichée
data.lyrics[].textLe texte des paroles à afficher à l’horodatage spécifié
data.waveformTableau de données de forme d’onde pour la visualisation audio
data.durationDurée totale de la piste audio en secondes
