Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Noch keine Ausgabe. Senden Sie das Formular ab, um Inhalte zu generieren.
Entdecken Sie verschiedene Anwendungsfälle und Parameterkonfigurationen
Transparente Preisgestaltung ohne versteckte Gebühren. Bezahlen Sie nach Verbrauch.
| Regel & Modalität | Channel | Guthaben | Preis (USD) | Offizieller / Referenzpreis | Tägliche Ersparnis |
|---|---|---|---|---|---|
Suno timestamped-lyrics musicSuno | Starter | 1per run | $0.005 | - | - |
Vollständige Anleitung zur Verwendung von Suno
Rufen Sie mit Zeitstempeln versehene Songtexte für eine synchronisierte Anzeige während der Audiowiedergabe ab. Ideal für Songtextanzeigen im Karaoke-Stil in Musikplayer-Oberflächen.
Die Suno Timestamped Lyrics API stellt synchronisierte Songtextdaten für generierte Musiktitel bereit. Jede Songtextzeile enthält präzise Zeitstempelinformationen in Sekunden, sodass Entwickler Anzeigen im Karaoke-Stil, Funktionen zur Songtextsynchronisierung und verbesserte Musikerlebnisse bei der Wiedergabe erstellen können. Die API gibt außerdem Wellenformdaten für die Audiovisualisierung zurück und eignet sich damit ideal für den Aufbau umfassender Musikplayer-Oberflächen mit sowohl Songtextanzeige als auch visueller Audiodarstellung.
Die Suno Timestamped Lyrics API liefert Songtexte mit genauen Zeitstempelwerten in Sekunden und gewährleistet so eine perfekte Synchronisierung zwischen Textanzeige und Audiowiedergabe. Jede Songtextzeile ist präzise auf den Audiotrack abgestimmt.
Zusammen mit den zeitgestempelten Songtexten gibt die API Wellenformdaten-Arrays zurück, die für die Audiovisualisierung verwendet werden können. Dadurch können Entwickler reichhaltige, interaktive Musikplayer-Oberflächen mit visueller Audiodarstellung erstellen.
Die API-Ausgabe ist für Anwendungen im Karaoke-Stil optimiert. Mit präzisem Timing und vollständigem Songtext können Entwickler Funktionen wie das Hervorheben beim Mitsingen und scrollende Songtextanzeigen einfach implementieren.
Erstellen Sie ein Konto und erhalten Sie Ihren Suno Timestamped Lyrics API Key. Dieser Schlüssel authentifiziert alle Anfragen und verknüpft die Nutzung mit Ihrem Konto.
Verwenden Sie zunächst die Suno-API zur Musikgenerierung, um Ihren Audiotrack zu erstellen. Speichern Sie taskId und audioId aus der Generierungsantwort – diese benötigen Sie, um zeitgestempelte Songtexte abzurufen.
Rufen Sie die Timestamped Lyrics API mit Ihrer taskId und audioId auf. Die API gibt synchronisierte Songtextdaten mit präzisen Zeitstempeln und Wellenforminformationen zurück.
Verwenden Sie die zeitgestempelten Daten, um synchronisierte Songtextanzeigen in Ihrer Anwendung zu erstellen. Kombinieren Sie sie mit Wellenformdaten für verbesserte visuelle Effekte.
Die API erfordert die beiden Parameter taskId und audioId. taskId identifiziert die Generierungssitzung, während audioId den genauen Track innerhalb dieser Sitzung angibt.
Alle Zeitstempelwerte werden in Sekunden als Gleitkommazahlen bereitgestellt. Dies ermöglicht bei Bedarf eine präzise Synchronisierung bis auf Millisekundenebene.
Für Tracks, die mit instrumental=true generiert wurden, sind keine Songtextdaten verfügbar. Die API gibt dennoch Wellenform- und Dauerinformationen zurück.
Integrieren Sie synchronisierte Songtexte in Musikplayer-Anwendungen, damit Nutzer dem Song in Echtzeit folgen können – mit hervorgehobenem Text, der zur Audiowiedergabe passt.
Erstellen Sie Karaoke-Funktionen mit präzisem Songtext-Timing, damit Nutzer mit visuellen Hinweisen mitsingen können, die Songtexte genau im richtigen Moment hervorheben.
Erstellen Sie Lernanwendungen, die Nutzern helfen, Songtexte zu lernen, Songstrukturen zu verstehen und Timing mit einer präzisen synchronisierten Textanzeige zu üben.
Verbessern Sie Musik-Sharing-Funktionen auf sozialen Plattformen, indem Sie synchronisierte Songtexte parallel zur Audiowiedergabe anzeigen und so ansprechendere Content-Erlebnisse schaffen.
apipass.dev bietet kosteneffiziente Preise für den Zugriff auf die Suno Timestamped Lyrics API und macht sie damit für Projekte jeder Größe zugänglich – von einzelnen Entwicklern bis hin zu groß angelegten Anwendungen.
Klare, detaillierte API-Dokumentation mit Codebeispielen und Integrationsleitfäden hilft Entwicklern, Funktionen für zeitgestempelte Songtexte schnell in ihren Anwendungen zu implementieren.
Technischer Support rund um die Uhr stellt sicher, dass Ihre Funktionen zur Songtextsynchronisierung betriebsbereit bleiben – mit fachkundiger Unterstützung, wann immer Sie sie benötigen.
Alle APIs erfordern eine Authentifizierung über Bearer Token.
Authorization: Bearer
Verwenden Sie das SDK, um Tasks zu erstellen, die zurückgegebene taskId zu speichern und Ergebnisse für Suno abzurufen.
Installieren Sie @apipass-dev/apipass-sdk, bevor Sie diese SDK-Beispiele ausführen.
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkSpeichern Sie Ihren API-Schlüssel in serverseitigen Umgebungsvariablen. Das SDK sendet ihn automatisch als Bearer Token und fügt JSON-Header hinzu.
client.jobs.createTaskLiedtexte mit Zeitstempeln für die synchronisierte Anzeige während der Audiowiedergabe abrufen
Mit diesem Beispiel können Sie schnell mit dem ausgewählten SDK starten.
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);Die API akzeptiert eine JSON-Nutzlast mit folgender Struktur:
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}modelErforderlichstringDer Modellname, der zum Abrufen von Liedtexten mit Zeitstempeln verwendet wird
"suno/timestamped-lyrics"
channelOptionalstringSie können den entsprechenden Anbieter innerhalb von APIPASS über den Parameter channel angeben; diese Anbieter übernehmen die eigentlichen Aufgaben zur Bild- und Videogenerierung. APIPASS bietet derzeit drei Anbieteroptionen:
Der Standardwert für den Parameter channel ist auto. Wenn aktiviert, verteilt APIPASS Aufgaben automatisch auf verfügbare Anbieter basierend auf Echtzeitpreisen und Stabilitätsmetriken, um minimale Kosten und zuverlässige Leistung auszubalancieren. Behalten Sie den Standardwert auto bei, sofern Sie keine benutzerdefinierten Routing-Anforderungen haben.
Verfügbare Optionen:
auto
Das input-Objekt enthält basierend auf der Formularkonfiguration die folgenden Parameter:
input.taskIdErforderlichstringDie von einem vorherigen suno/generate- oder suno/extend-createTask-Aufruf zurückgegebene ApiPass-taskId. Übergeben Sie nicht die Aufgaben-ID des vorgelagerten NextMusic-Anbieters.
Pflichtfeld, maximale Länge: 100 Zeichen
"task_12345678"
input.audioIdErforderlichstringDie Audio-ID aus dem Ergebniselement der abgeschlossenen Quellaufgabe.
Pflichtfeld, maximale Länge: 100 Zeichen
"audio_abc123xyz"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_xxx"
6 }
7}codeStatuscode, 200 für Erfolg, andere Werte für Fehler
messageAntwortnachricht, Fehlerbeschreibung bei fehlgeschlagener Anfrage
data.lyricsArray von Liedtextobjekten, die jeweils einen Zeitstempel (in Sekunden) und Text enthalten
data.lyrics[].timestampZeitstempelwert in Sekunden, zu dem diese Liedtextzeile angezeigt werden soll
data.lyrics[].textDer Liedtext, der zum angegebenen Zeitstempel angezeigt werden soll
data.waveformWellenform-Datenarray für die Audiovisualisierung
data.durationGesamtdauer der Audiospur in Sekunden
client.jobs.recordInfoStatus der Cover-Generierungsaufgabe abfragen und Ergebnisse abrufen
Mit diesem Beispiel können Sie schnell mit dem ausgewählten SDK starten.
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.stateAktueller Status: queuing, generating, success oder fail
data.resultJson.dataArray der generierten Cover-Versionen mit URLs und Metadaten
Die API-Seite zeigt das Parameterschema, aber Suno hat auch mehrere geschäftsspezifische Kombinations- und Callback-Regeln, die leicht übersehen werden können.
Alle APIs erfordern eine Authentifizierung über Bearer Token.
Authorization: Bearer
Liedtexte mit Zeitstempeln für die synchronisierte Anzeige während der Audiowiedergabe abrufen
Die API akzeptiert eine JSON-Nutzlast mit folgender Struktur:
1{
2 "model": "suno/timestamped-lyrics",
3 "input": {
4 "taskId": "string",
5 "audioId": "string"
6 },
7 "channel": "auto"
8}modelErforderlichstringDer Modellname, der zum Abrufen von Liedtexten mit Zeitstempeln verwendet wird
"suno/timestamped-lyrics"
channelOptionalstringSie können den entsprechenden Anbieter innerhalb von APIPASS über den Parameter channel angeben; diese Anbieter übernehmen die eigentlichen Aufgaben zur Bild- und Videogenerierung. APIPASS bietet derzeit drei Anbieteroptionen:
Der Standardwert für den Parameter channel ist auto. Wenn aktiviert, verteilt APIPASS Aufgaben automatisch auf verfügbare Anbieter basierend auf Echtzeitpreisen und Stabilitätsmetriken, um minimale Kosten und zuverlässige Leistung auszubalancieren. Behalten Sie den Standardwert auto bei, sofern Sie keine benutzerdefinierten Routing-Anforderungen haben.
Verfügbare Optionen:
auto
Das input-Objekt enthält basierend auf der Formularkonfiguration die folgenden Parameter:
input.taskIdErforderlichstringDie von einem vorherigen suno/generate- oder suno/extend-createTask-Aufruf zurückgegebene ApiPass-taskId. Übergeben Sie nicht die Aufgaben-ID des vorgelagerten NextMusic-Anbieters.
Pflichtfeld, maximale Länge: 100 Zeichen
"task_12345678"
input.audioIdErforderlichstringDie Audio-ID aus dem Ergebniselement der abgeschlossenen Quellaufgabe.
Pflichtfeld, maximale Länge: 100 Zeichen
"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}codeStatuscode, 200 für Erfolg, andere Werte für Fehler
messageAntwortnachricht, Fehlerbeschreibung bei fehlgeschlagener Anfrage
data.lyricsArray von Liedtextobjekten, die jeweils einen Zeitstempel (in Sekunden) und Text enthalten
data.lyrics[].timestampZeitstempelwert in Sekunden, zu dem diese Liedtextzeile angezeigt werden soll
data.lyrics[].textDer Liedtext, der zum angegebenen Zeitstempel angezeigt werden soll
data.waveformWellenform-Datenarray für die Audiovisualisierung
data.durationGesamtdauer der Audiospur in Sekunden
