suno-api

Suno erstellt Musik aus einer kurzen schriftlichen Idee. Der dokumentierte automatische Ablauf erzeugt zwei Songs und bietet eine Instrumentaloption; fertige Audiodateien und Metadaten der Titel werden über den Generierungsauftrag zurückgegeben.

Ailoot Ultra · Music POST /v1/music/generations suno-api

Über das Modell

Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.

Suno ist ein Dienst zur Musikgenerierung, der eine schriftliche Idee in Songs umsetzt. Der dokumentierte automatische Workflow nimmt eine kurze Beschreibung der gewünschten Musik und die Auswahl der Instrumentaloption entgegen und erzeugt anschließend zwei Songs. Legen Sie im Briefing Thema, Stimmung und musikalische Richtung fest, die Sie in den fertigen Titeln hören möchten.

Beginnen Sie mit der Aufgabe, die die Musik erfüllen soll. Ein ruhiger Hintergrund für eine Erklärung, ein energiegeladener Auftakt für ein kurzes Video oder ein nachdenklicher Song über eine Reise gibt dem Briefing jeweils einen konkreten Zweck. Beschreiben Sie die gewünschte Stimmung und die musikalischen Merkmale, die für diesen Zweck wichtig sind, in wenigen klaren Formulierungen.

Machen Sie bei einem Song mit Gesang Thema und Sprache im kreativen Briefing deutlich. Beschreiben Sie die Idee, die der Titel ausdrücken soll, und den Ausdruck, den die Darbietung vermitteln soll. Hören Sie sich im fertigen Ergebnis an, wie Gesang, Text und Arrangement zusammenwirken. Bewahren Sie die erzeugten Titelinformationen für die Prüfung zusammen mit der Audiodatei auf.

Verwenden Sie für ein Instrumentalstück die dokumentierte Instrumentaloption und beschreiben Sie die musikalische Richtung im Text. Nennen Sie die gewünschte Atmosphäre und prägende Instrumente, wenn diese für das Projekt wichtig sind. Prüfen Sie den fertigen Titel im Hinblick auf seine Position im Schnitt, einschließlich der Abschnitte, die gesprochenen Text unterlegen oder einen visuellen Übergang unterstützen sollen.

Der automatische Workflow erzeugt aus der eingereichten Idee zwei Songs. Behandeln Sie diese als eigenständige Varianten und bewahren Sie beide fertigen Audiodateien auf. Hören Sie jeden Titel vom Anfang über die Entwicklung bis zum Ende an. Vergleichen Sie die tatsächlichen Titel anhand desselben Zwecks, einschließlich Stimmung, Arrangement und Eignung für den geplanten Einsatz.

Die Generierung ist als Auftrag organisiert. Bewahren Sie die zurückgegebene Auftrags-ID auf, während Sie das Ergebnis prüfen, und unterscheiden Sie fertige Titel von Einträgen, die noch in Bearbeitung sind. Das dokumentierte Ergebnis enthält Informationen je Titel, etwa Titelname, Status, Speicherort der Audiodatei und Dauer. Speichern Sie die fertige Audiodatei selbst zusammen mit den verfügbaren Metadaten und dem ursprünglichen Briefing.

Hören Sie sich die ausgewählte Musik bei einem Video oder einer Präsentation im Zusammenspiel mit dem tatsächlichen Material an. Prüfen Sie Anfang, Übergänge und Ende bei der vorgesehenen Abhörlautstärke. Markieren Sie den Abschnitt, der dem Schnitt dient, und bewahren Sie den vollständigen Titel für spätere Änderungen auf. Ob ein Musikausschnitt passt, wird im Zusammenhang mit Stimme, Bildern und Rhythmus des fertigen Werks beurteilt.

Bewahren Sie die schriftliche Idee, die gewählte Instrumentaloption, die Modellauswahl und alle fertigen Titel zusammen auf. Benennen Sie bei einer nötigen Überarbeitung die musikalische Abweichung, etwa ein Arrangement, das als Begleitung zu gesprochenem Text zu dicht ist, oder einen Einstieg, der sich zu langsam entwickelt. Behalten Sie die brauchbare Richtung bei und überarbeiten Sie den Teil des Briefings, der mit diesem Problem zusammenhängt.

Ailoot Ultra · Music POST /v1/music/generations suno-api

suno-api

Suno /suno-api

Einstieg

Zulässige Eingaben: Text
Ergebnisse: Audio · Bilder · Video

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Music POST /v1/music/generations

Eingabe: text
Ausgabe: audio, image, video

Feld	Typ	Anforderung	Werte und Limits	Standard
Feld`model`	Typ`string`	AnforderungErforderlich	Werte und Limits suno-api Bedingungen: Verwenden Sie genau diesen Ailoot-Routingselektor.	Standard—
Feld`gpt_description_prompt`	Typ`string`	AnforderungErforderlich	Werte und Limits Bedingungen: Beschreiben Sie die musikalische Idee oder das Thema des Liedes.	Standard—
Feld`mv`	Typ`string`	AnforderungErforderlich	Werte und Limits chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Bedingungen: Wählen Sie ausdrücklich eine dokumentierte Suno-Version aus; das Beispiel verwendet chirp-crow (v5).	Standard—
Feld`make_instrumental`	Typ`boolean`	AnforderungErforderlich	Werte und Limits Bedingungen: Setzen Sie true für Instrumentalmusik oder false für ein Lied.	Standard—

Methodenparameter und Lebenszyklus

Parameter	Vertrag
Parameter`content_type`	Vertragapplication/json
Parameter`required`	Vertragmodel, gpt_description_prompt, mv, make_instrumental
Parameter`optional`	Vertrag
Parameter`material_types`	Vertragtext
Parameter`conditions`	VertragVerwenden Sie genau diesen Ailoot-Routingselektor., Beschreiben Sie die musikalische Idee oder das Thema des Liedes., Wählen Sie ausdrücklich eine dokumentierte Suno-Version aus; das Beispiel verwendet chirp-crow (v5)., Setzen Sie true für Instrumentalmusik oder false für ein Lied.

Lebenszyklus: submit_once_poll_original

GET /v1/music/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarife

So wird die endgültige Gebühr berechnet

Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.

Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.

Schnellmodus: Nicht angegeben Wenn der Schnellmodus ausgewählt ist
Flex-Modus: Nicht angegeben Wenn der Modus flex ausgewählt ist
Maximaler Denkaufwand: Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

Konfiguration	Tarifstaffel	Prognostizierte Menge	Abrechnungsmenge	Gebühr
KonfigurationBasistarife für Tokens	TarifstaffelGrundtarif	Prognostizierte Menge—	Abrechnungsmenge—	Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens
KonfigurationJe Anfrage	Tarifstaffel—	Prognostizierte Menge—	Abrechnungsmengeeine Anfrage	Gebühr Eingabe · Schätzung nur zum Vergleich $0.2 pro Anfrage
KonfigurationGeschätzte Generierungskosten	Tarifstaffel—	Prognostizierte MengeSchätzung für eine Generierung	Abrechnungsmenge—	Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.2 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.

Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Beispielanfragen

Ailoot Ultra · Music

curl · einmal erstellen und den Beleg speichernDen ursprünglichen Auftrag auslesenJedes fertiggestellte eigene Asset speichern

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "suno-api",
  "gpt_description_prompt": "古诗词",
  "mv": "chirp-crow",
  "make_instrumental": false
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.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)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        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"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    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"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Ergebnisse abrufen und speichern

Ailoot Ultra · Music

Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt

GET /v1/music/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Alle fertiggestellten Ergebnisse aufbewahren

Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.

Bewahren Sie die vollständige Antwort und die Header, die ursprünglichen Kennungen, jede tatsächliche Ausgabe und alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und erhalten Sie jede Rolle, die darauf verweist.

Wenn die ursprüngliche Antwort geprüft werden muss

Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-id und alle Header auf. Lesen Sie ausschließlich die ursprüngliche Aufgabe; unknown oder result_pending_check berechtigen nicht zu einer weiteren Erstellung.

Antwortfelder

Feld	Typ
Feld`id`	Typstring
Feld`polling_url`	Typstring
Feld`provider_task_id`	Typstring
Feld`data.task_id`	Typstring
Feld`data.status`	Typstring
Feld`data.data[].audio_url`	Typstring
Feld`data.data[].image_url`	Typstring
Feld`data.data[].image_large_url`	Typstring
Feld`data.data[].video_url`	Typstring

Aliasnamen

Modellaliasnamen

Ailoot Ultra suno-api

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

suno-api

FAQ · suno-api

Welche Eingaben und Ergebnisse sind verfügbar?: POST /v1/music/generations · suno-api: text → audio, image, video
Welche Felder verwendet die Anfrage?: POST /v1/music/generations · suno-api: model, gpt_description_prompt, mv, make_instrumental

suno-api

suno-api

Einstieg

In Ailoot verfügbar · Eingaben und Methoden

Tarife

So wird die endgültige Gebühr berechnet

Geschätzte Tarife zum Vergleich

Preise nach Konfiguration

Beispielanfragen

Ailoot Ultra · Music

Ergebnisse abrufen und speichern

Ailoot Ultra · Music

Alle fertiggestellten Ergebnisse aufbewahren

Wenn die ursprüngliche Antwort geprüft werden muss

Aliasnamen

Modellaliasnamen

Aliasnamen für Methodenpfade

Zugehörige Aufrufer-IDs

Das Unternehmen und sein Projektportfolio

Tokens mit Rabatt kaufen.

Verbinden Sie die API mit dem Produkt, das Sie verkaufen.