Audio

Suno V5

Die Suno API erstellt studiofertige Musik aus Prompts, Stilen und Songtexten und liefert zwei Tracks pro Durchlauf mit asynchroner, produktionsfreundlicher Bereitstellung.

$0.12 / use

2 Tracks pro DurchlaufAsynchroner WorkflowPrompt- und Songtext-SteuerungMP3 + Cover-Art

Parameter

Model Version*

Custom Mode*

Aktiviert

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Deaktiviert

Vocal Gender Preference

Ausgabe

Erstellte Inhalte werden hier angezeigt

Endpunkte

POSThttps://api.apixo.ai/api/v1/generateTask/sunoTask erstellen

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Status abfragen

Authentifizierung

API-Zugriff wird geprüft...

Melden Sie sich an, um kostenloses Guthaben zu erhalten, den Playground zu testen und mit der API-Integration fortzufahren.

Request-Body

request_type

async

Verwenden Sie Callback mit callback_url für Webhooks.

provider

official

Entspricht dem Seedance 2.0 Handbuch.

input

Objekt

Modus, Prompt, Referenzen, Größe, Dauer und Audio-Einstellungen.

Parameter

request_typeerforderlich

Typselect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlbedingt

Typtext

Publicly accessible URL for callback mode.Nur in request_type=callback

modeerforderlich

Typselect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModeerforderlich

Typboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titleerforderlich

Typtext

Appears in metadata and can steer theme. Required when Custom Mode is on.Nur in customMode=

styleerforderlich

Typstring

Describe genre/mood/instrumentation. Required in Custom Mode.Nur in customMode=

promptbedingt

Typstring

Provide full lyrics for sung output. Required when Instrumental is off.Nur in customMode=

songDescriptionerforderlich

Typstring

Simple mode: one field to steer both style and topic when Custom Mode is off.Nur in customMode=

instrumentalerforderlich

Typboolean

Turn on to generate backing track without vocals.

negativeTagsbedingt

Typstring

Negative TagsNur in customMode=

styleWeightbedingt

Typslider

How strongly to follow the Style description.Nur in customMode=

weirdnessConstraintbedingt

Typslider

Push creativity/experimentation. Higher = wilder.Nur in customMode=

audioWeightbedingt

Typslider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Nur in customMode=

vocalGenderbedingt

Typselect

Best-effort vocal timbre preference (custom mode only).f · mNur in customMode=

Parameter	Typ	Erforderlich	Beschreibung
`request_type`	select	erforderlich	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	bedingt	Publicly accessible URL for callback mode.Nur in request_type=callback
`mode`	select	erforderlich	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	erforderlich	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	erforderlich	Appears in metadata and can steer theme. Required when Custom Mode is on.Nur in customMode=
`style`	string	erforderlich	Describe genre/mood/instrumentation. Required in Custom Mode.Nur in customMode=
`prompt`	string	bedingt	Provide full lyrics for sung output. Required when Instrumental is off.Nur in customMode=
`songDescription`	string	erforderlich	Simple mode: one field to steer both style and topic when Custom Mode is off.Nur in customMode=
`instrumental`	boolean	erforderlich	Turn on to generate backing track without vocals.
`negativeTags`	string	bedingt	Negative TagsNur in customMode=
`styleWeight`	slider	bedingt	How strongly to follow the Style description.Nur in customMode=
`weirdnessConstraint`	slider	bedingt	Push creativity/experimentation. Higher = wilder.Nur in customMode=
`audioWeight`	slider	bedingt	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Nur in customMode=
`vocalGender`	select	bedingt	Best-effort vocal timbre preference (custom mode only).f · mNur in customMode=

Beispiel (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Vollständige API-Dokumentation

Beispiel-Ausgaben

Erstellt mit der Suno V5 API auf APIXO

2 Tracks

Neon Freeway Nights

Ansehen

Vollständiger Leitfaden

Was ist die Suno API?

Die Suno API ist eine Text-zu-Musik-Schnittstelle, die für schnelle Produktions-Workflows entwickelt wurde. Sie kann Prompts, Stil-Tags und benutzerdefinierte Songtexte in zwei vollständige Song-Ausgaben mit zugehörigen Cover-Bildern verwandeln.

Dies macht es ideal für Creator-Tools, die Erstellung von Marken-Content und automatisierte Musikproduktionen, bei denen schnelle Iteration wichtiger ist als manuelle Komposition.

So funktioniert der Erstellungs-Workflow

Senden Sie eine Erstellungsanfrage mit Parametern für den reinen Prompt-Modus oder den benutzerdefinierten Songtext-Modus.
Erhalten Sie den Aufgabenstatus asynchron über Polling oder einen Callback-Endpunkt.
Bei Erfolg werden zwei erstellte Tracks sowie die zugehörigen Artwork-Metadaten verbraucht.

Technische Spezifikationen der Suno API

Betriebsmerkmale, die für die Produkt- und Backend-Integration relevant sind.

Outputs

2 Tracks pro Erstellung

Steuerungsoberfläche

Stil, Weirdness, Audio-Gewichtung

Erstellungsmodi

Nur-Prompt- und benutzerdefinierter Songtext-Modus

Bereitstellung

Asynchrones Polling oder Callback

Kernfunktionen

Zwei-Spur-Ausgabe

Jede Erstellung liefert zwei Songvarianten, was die A/B-Auswahl und kreative Iteration für Produktionsteams beschleunigt.

Schieberegler für kreative Kontrolle

Passen Sie Style-Weight, Weirdness und Audio-Weight an, um die Ergebnisse von sicheren kommerziellen Tracks zu experimentellen Texturen zu bewegen.

Lyrics- und Vocal-Workflows

Unterstützt reine Prompt-Erstellung und benutzerdefinierten Songtext-Modus mit optionalen Präferenzen für Instrumentalstücke und das Geschlecht der Stimme.

Bereit für asynchrone Integration

Funktioniert mit Polling- oder Callback-Strategien und lässt sich so einfach in warteschlangenbasierte Backend-Workflows integrieren.

Was können Sie bauen?

In-App Musik-Erstellung

Erstellen Sie Marken-Musik-Snippets und Creator-freundliche Tracks für UGC, Kurzvideos und Social-Creation-Tools.

Podcast- und Video-Branding

Erstellen Sie Intro- und Outro-Tracks, Bumper und wiederkehrende Themenmotive mit steuerbarer Stimmung und Geschwindigkeit.

Soundtracks für Kurzform-Inhalte

Erstellen Sie benutzerdefinierte Hintergrundmusik für TikTok, Shorts und Reels mit schneller Iteration von Stil und Lyric-Hooks.

Game- und interaktives Audio

Prototyping von Ambient-Loops, Menü-Themes und leichten Score-Ideen für Spiele und interaktive Erlebnisse.

Hinweise & Einschränkungen

Jede Erstellung liefert genau zwei Spuren; die Anzahl der Ausgaben kann nicht angepasst werden.
Der Playground-Workflow ist async-first; Callback-Orchestrierung ist auf API-Ebene verfügbar.
Die Prompt-/Lyric-Länge im Custom-Modus ist in den unterstützten Versionen auf 5.000 Zeichen begrenzt.
Vokales Geschlecht und stimmliche Merkmale sind Best-Effort-Steuerungen, keine strikten Garantien.

Häufig gestellte Fragen

Jetzt starten

Testen Sie den Playground oben und wechseln Sie zur API-Dokumentation, sobald Sie bereit für die Integration sind.

Playground testen API-Dokumentation ansehen

Suno V5

Beispiel-Ausgaben

Was ist die Suno API?

So funktioniert der Erstellungs-Workflow

Technische Spezifikationen der Suno API

Outputs

Steuerungsoberfläche

Erstellungsmodi

Bereitstellung

Kernfunktionen

Zwei-Spur-Ausgabe

Schieberegler für kreative Kontrolle

Lyrics- und Vocal-Workflows

Bereit für asynchrone Integration

Was können Sie bauen?

In-App Musik-Erstellung

Podcast- und Video-Branding

Soundtracks für Kurzform-Inhalte

Game- und interaktives Audio

Hinweise & Einschränkungen

Häufig gestellte Fragen

Kann ich nur einen Track statt zwei erstellen?

Kann ich eine exakte Textausgabe (Lyrics) erzwingen?

Ist diese API synchron?

Welcher Dateityp wird zurückgegeben?

Jetzt starten