Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Noch kein Audio. Senden Sie das Formular ab, um Audio 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 generate musicSuno | Starter | 1per run | $0.005 | - | - |
Vollständige Anleitung zur Verwendung von Suno
Über ApiPass können Sie `suno/generate` nutzen, um eine natürlichsprachige Beschreibung direkt in einen vollständigen Song umzuwandeln. Ob Tracks mit Vocals, instrumentale Hintergrundmusik, Werbemusik oder schnelle Song-Demos: ApiPass bietet eine einheitliche Task-API, asynchrone Abfrage und stabile Webhooks für Prototypen und produktive Systeme.
Suno Generate ist Sunos Text-zu-Musik-Funktion, mit der sich komplette Songs aus einer Textbeschreibung erstellen lassen. Sie können Stil, Titel, Instrumentalmodus und Stimmgeschlecht festlegen und im erweiterten Modus zusätzlich Stilgewichtung, Kreativitätsgrad und Ausschluss-Tags steuern. Über ApiPass rufen Entwickler Suno V5_5, V4.5PLUS, V4.5ALL, V4.5 und V4 über eine einheitliche API auf, ohne die zugrunde liegende Kontologik selbst verwalten zu müssen.
Eine kurze Beschreibung von Thema, Stimmung, Tempo oder Szene reicht aus, um einen kompletten Song zu erzeugen. Das eignet sich für kreative Exploration, schnelle Marketinginhalte und Produkte mit "Beschreibe einen Song, erzeuge ein Ergebnis"-Workflows.
Wenn Sie präzisere Kontrolle benötigen, aktivieren Sie `customMode` und übergeben `style` sowie `title`. Das verbessert die Konsistenz für Genre, Benennung und Produktions-Templates bei größeren Workflows.
Da die Musikgenerierung meist einige Dutzend Sekunden dauert, stellt ApiPass Suno als Task-Workflow bereit. Sie können `/api/v1/jobs/recordInfo` pollen oder mit `callBackUrl` Webhooks nutzen, um Ergebnisse automatisch weiterzuverarbeiten.
Generieren Sie komplette Songs mit KI-gesungenen Stimmen und kohärenten Texten, die zu Ihrem Prompt passen. Das Suno V5_5-Modell erzeugt natürlich klingende Stimmen in mehreren Sprachen und Stilen.
Erstellen Sie reine Instrumentalstücke ohne Gesang. Perfekt für Hintergrundmusik, Spielesoundtracks, Meditations-Apps und alle Anwendungsfälle, die Musik ohne Text erfordern.
Unterstützung für Hunderte von Musikgenres von Pop, Rock und Hip-Hop bis hin zu klassischer, elektronischer und Weltmusik. Kombinieren Sie mehrere Stile und verwenden Sie negative Tags, um unerwünschte Elemente auszuschließen.
Wählen Sie zwischen männlichen und weiblichen Stimmen, um Ihrer kreativen Vision gerecht zu werden. Die KI liefert natürlich klingende Stimmen, die sich dem musikalischen Stil anpassen.
Verfeinern Sie Ihre Kreationen mit den Parametern Stil-Gewichtung, Verrücktheits-Einschränkung und Audio-Gewichtung. Finden Sie die Balance zwischen strikter Befolgung von Prompts und kreativer Entdeckung.
Diese Abläufe eignen sich besonders gut für `suno/generate` in Verbindung mit Async-Tasks und Webhooks.
Lassen Sie Nutzer aus einem einzelnen Prompt sofort zwei Songentwürfe erhalten. Das eignet sich für Kreativ-Tools, Entertainment und Ideenfindung.
Wandeln Sie Kampagnentexte, Produktbotschaften oder Werbewinkel in stilistisch passende Musik für größere Content-Produktionen um.
Geben Sie sofort eine Task-ID zurück und schreiben Sie Audio-URLs, Cover-Bilder und Metadaten nach erfolgreichem Webhook in Ihr System zurück.
Da jede Generierung mehrere Varianten liefert, passt Suno Generate gut in interne Review-, Freigabe- und Veröffentlichungsprozesse.
Die passende Schnittstelle hängt davon ab, ob Sie bei Null starten oder auf bestehendem Material aufbauen.
Wenn Sie zunächst nur Songtexte erzeugen möchten, ist `suno/lyrics` die richtige Wahl. Wenn Sie direkt ein vollständiges Song-Ergebnis inklusive Audio und Cover benötigen, verwenden Sie `suno/generate`.
`suno/generate` ist für neue Songs von Grund auf gedacht. Wenn Sie einen bestehenden Suno-Track fortsetzen möchten, passt `suno/extend`; für eine stilistische Neuinterpretation vorhandenen Audios ist `suno/cover` besser geeignet.
Bieten Sie Nutzern Werkzeuge zum Generieren von Songs aus einer Zeile Text, zum Ausprobieren von Stilrichtungen und zum schnellen Anhören von Ideen.
Erzeugen Sie automatisch passende Musik aus Kampagnentexten, Produktbotschaften oder Szenenbeschreibungen für Ads, Social Content und Promo-Clips.
Leiten Sie aus Story- oder Szenenbeschreibungen schnell musikalische Skizzen für Games, Characters und interaktive Experiences ab.
Kombinieren Sie Suno Generate mit Warteschlangen, CMS-Systemen oder Automationen, um Ergebnisse im Hintergrund zu erzeugen und später an Clients zurückzugeben.
Erstellen Sie im ApiPass-Dashboard einen API-Key. Dieser Schlüssel authentifiziert alle Anfragen an `suno/generate`.
Senden Sie eine Anfrage an `/api/v1/jobs/createTask` mit `model: "suno/generate"` und den gewünschten Parametern in `input`. Die API gibt sofort eine `taskId` zurück.
Nutzen Sie `taskId` mit `/api/v1/jobs/recordInfo` oder setzen Sie `callBackUrl`, um nach Abschluss Audio-URLs, Coverbilder und Metadaten automatisch zu erhalten.
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.createTaskErstellt eine neue Aufgabe zur Musikgenerierung mit Suno V5
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/generate",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
12 "customMode": false,
13 "instrumental": false,
14 "vocalGender": "f"
15 }
16});
17
18console.log(task.data.taskId);Die API akzeptiert eine JSON-Payload mit der folgenden Struktur:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}modelErforderlichstringModellkennung für die Musikgenerierung mit Suno V5
"suno/generate"
callBackUrlOptionalstringURL zum Empfangen von Webhook-Benachrichtigungen, wenn die Generierung abgeschlossen ist
"https://your-domain.com/api/callback"
channelOptionalstringSie können über den Parameter channel den entsprechenden Anbieter innerhalb von APIPASS festlegen; 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 Echtzeit-Preisen und Stabilitätsmetriken, um minimale Kosten und zuverlässige Leistung auszugleichen. Behalten Sie den Standardwert auto bei, sofern Sie keine individuellen Routing-Anforderungen haben.
Verfügbare Optionen:
auto
Parameter für die Musikgenerierung:
input.model_versionOptionalstringZu verwendende Suno-Modellversion. Standardmäßig V5.
Verfügbare Optionen:
"V5"
input.promptOptionalstringTextbeschreibung der zu generierenden Musik. Erforderlich, wenn customMode false ist oder wenn customMode true und instrumental false ist.
customMode=false: prompt ist erforderlich, maximal 500 Zeichen. customMode=true + instrumental=false: prompt ist erforderlich. customMode=true + instrumental=true: prompt ist optional. Für customMode=true: V4: maximal 3000 Zeichen; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: maximal 5000 Zeichen
"A catchy pop song about summer love with upbeat tempo"
input.customModeOptionalbooleanAktiviert den benutzerdefinierten Modus für mehr Kontrolle. Wenn true, sind style und title erforderlich.
Wenn customMode=false ist, werden style und title ignoriert und nicht an den Anbieter gesendet.
Parametermodi:
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalOptionalbooleanGeneriert Instrumentalmusik ohne Gesang.
false
input.styleOptionalstringMusikstil/Genre. Erforderlich, wenn customMode true ist.
Erforderlich, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. V4: maximal 200 Zeichen; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: maximal 1000 Zeichen
"Pop, Upbeat, Summer Vibes"
input.titleOptionalstringTitel für die generierte Musik. Erforderlich, wenn customMode true ist.
Maximale Länge: 80 Zeichen
"Summer Love"
input.vocalGenderOptionalstringGeschlecht der Gesangsstimme im generierten Song.
Nur wirksam, wenn customMode=true ist.
Verfügbare Optionen:
"f"
input.personaIdOptionalstringPersona-ID für den generierten Song.
Nur wirksam, wenn customMode=true ist.
"1234567890"
input.negativeTagsOptionalstringStile oder Merkmale, die von der Generierung ausgeschlossen werden sollen.
Nur wirksam, wenn customMode=true ist.
"aggressive, heavy metal, screaming"
input.styleWeightOptionalnumberWie strikt der Stil befolgt werden soll. Bereich: 0.0-1.0
Nur wirksam, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. Zahl zwischen 0.00 und 1.00. Muss in Schritten von 0.01 verwendet werden. Boolesche Werte werden nicht akzeptiert.
0.5
input.weirdnessConstraintOptionalnumberSteuert den Kreativitätsgrad. Höhere Werte erzeugen experimentellere Ergebnisse. Bereich: 0.0-1.0
Nur wirksam, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. Zahl zwischen 0.00 und 1.00. Muss in Schritten von 0.01 verwendet werden. Boolesche Werte werden nicht akzeptiert.
0.3
input.audioWeightOptionalnumberGewichtung des Audioeinflusses für die Generierung. Bereich: 0.0-1.0
Nur wirksam, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. Zahl zwischen 0.00 und 1.00. Muss in Schritten von 0.01 verwendet werden. Boolesche Werte werden nicht akzeptiert.
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeStatuscode, 200 bei Erfolg
messageAntwortnachricht
data.taskIdEindeutige Aufgaben-ID zum Abfragen von Status und Ergebnissen
Wenn die Generierung abgeschlossen ist, wird eine POST-Anfrage an Ihre callBackUrl gesendet
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "completeTime": 1755599644000,
7 "costTime": 45000,
8 "createTime": 1755599599000,
9 "model": "suno/generate",
10 "resultJson": {
11 "data": [
12 {
13 "id": "audio_001",
14 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
15 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
16 "duration": 180.5,
17 "title": "Summer Love",
18 "style": "Pop"
19 },
20 {
21 "id": "audio_002",
22 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_audio.mp3",
23 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_cover.jpeg",
24 "duration": 175.2,
25 "title": "Summer Love",
26 "style": "Pop"
27 }
28 ]
29 }
30 },
31 "msg": "Task completed successfully."
32}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "fail",
6 "failCode": "GENERATION_FAILED",
7 "failMsg": "Music generation failed due to content policy violation"
8 },
9 "msg": "Task failed."
10}client.jobs.recordInfoAufgabenstatus abfragen und generierte Musik 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("task_abc123xyz");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}codeStatuscode, 200 bei Erfolg
data.taskIdDie Aufgaben-ID
data.stateAktueller Status: queuing, generating, success oder fail
data.resultJson.dataArray generierter Audiotracks 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
Erstellt eine neue Aufgabe zur Musikgenerierung mit Suno V5
Die API akzeptiert eine JSON-Payload mit der folgenden Struktur:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}modelErforderlichstringModellkennung für die Musikgenerierung mit Suno V5
"suno/generate"
callBackUrlOptionalstringURL zum Empfangen von Webhook-Benachrichtigungen, wenn die Generierung abgeschlossen ist
"https://your-domain.com/api/callback"
channelOptionalstringSie können über den Parameter channel den entsprechenden Anbieter innerhalb von APIPASS festlegen; 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 Echtzeit-Preisen und Stabilitätsmetriken, um minimale Kosten und zuverlässige Leistung auszugleichen. Behalten Sie den Standardwert auto bei, sofern Sie keine individuellen Routing-Anforderungen haben.
Verfügbare Optionen:
auto
Parameter für die Musikgenerierung:
input.model_versionOptionalstringZu verwendende Suno-Modellversion. Standardmäßig V5.
Verfügbare Optionen:
"V5"
input.promptOptionalstringTextbeschreibung der zu generierenden Musik. Erforderlich, wenn customMode false ist oder wenn customMode true und instrumental false ist.
customMode=false: prompt ist erforderlich, maximal 500 Zeichen. customMode=true + instrumental=false: prompt ist erforderlich. customMode=true + instrumental=true: prompt ist optional. Für customMode=true: V4: maximal 3000 Zeichen; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: maximal 5000 Zeichen
"A catchy pop song about summer love with upbeat tempo"
input.customModeOptionalbooleanAktiviert den benutzerdefinierten Modus für mehr Kontrolle. Wenn true, sind style und title erforderlich.
Wenn customMode=false ist, werden style und title ignoriert und nicht an den Anbieter gesendet.
Parametermodi:
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalOptionalbooleanGeneriert Instrumentalmusik ohne Gesang.
false
input.styleOptionalstringMusikstil/Genre. Erforderlich, wenn customMode true ist.
Erforderlich, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. V4: maximal 200 Zeichen; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: maximal 1000 Zeichen
"Pop, Upbeat, Summer Vibes"
input.titleOptionalstringTitel für die generierte Musik. Erforderlich, wenn customMode true ist.
Maximale Länge: 80 Zeichen
"Summer Love"
input.vocalGenderOptionalstringGeschlecht der Gesangsstimme im generierten Song.
Nur wirksam, wenn customMode=true ist.
Verfügbare Optionen:
"f"
input.personaIdOptionalstringPersona-ID für den generierten Song.
Nur wirksam, wenn customMode=true ist.
"1234567890"
input.negativeTagsOptionalstringStile oder Merkmale, die von der Generierung ausgeschlossen werden sollen.
Nur wirksam, wenn customMode=true ist.
"aggressive, heavy metal, screaming"
input.styleWeightOptionalnumberWie strikt der Stil befolgt werden soll. Bereich: 0.0-1.0
Nur wirksam, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. Zahl zwischen 0.00 und 1.00. Muss in Schritten von 0.01 verwendet werden. Boolesche Werte werden nicht akzeptiert.
0.5
input.weirdnessConstraintOptionalnumberSteuert den Kreativitätsgrad. Höhere Werte erzeugen experimentellere Ergebnisse. Bereich: 0.0-1.0
Nur wirksam, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. Zahl zwischen 0.00 und 1.00. Muss in Schritten von 0.01 verwendet werden. Boolesche Werte werden nicht akzeptiert.
0.3
input.audioWeightOptionalnumberGewichtung des Audioeinflusses für die Generierung. Bereich: 0.0-1.0
Nur wirksam, wenn customMode=true ist. Wird ignoriert, wenn customMode=false ist. Zahl zwischen 0.00 und 1.00. Muss in Schritten von 0.01 verwendet werden. Boolesche Werte werden nicht akzeptiert.
0.5
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/generate",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
9 "customMode": false,
10 "instrumental": false,
11 "vocalGender": "f"
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeStatuscode, 200 bei Erfolg
messageAntwortnachricht
data.taskIdEindeutige Aufgaben-ID zum Abfragen von Status und Ergebnissen
