Source: https://ailoot.ai/models/de-ch/suno-api/ Canonical: https://ailoot.ai/models/de-ch/suno-api/ Language: de-ch # suno-api [Markdown](https://ailoot.ai/models/de-ch/suno-api/index.md) · [JSON](https://ailoot.ai/models/de-ch/suno-api/facts.json) ## [suno-api](https://ailoot.ai/models/de-ch/suno-api/) Suno erstellt Musik aus einer kurzen schriftlichen Idee. Der dokumentierte automatische Ablauf erzeugt zwei Songs und enthält eine Instrumentaloption; fertige Audiodateien und Metadaten der Titel werden über den Generierungsauftrag zurückgegeben. - [**Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api`](https://ailoot.ai/models/de-ch/suno-api/#method-0) Ü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 Ablauf verarbeitet eine kurze Beschreibung der gewünschten Musik und eine Instrumentaloption und erzeugt anschliessend 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 Ton, 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, einschliesslich der Abschnitte, die gesprochenen Text unterlegen oder einen visuellen Übergang unterstützen sollen. Der automatische Ablauf 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, einschliesslich 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. Testen Sie die ausgewählte Musik bei einem Video oder einer Präsentation mit dem tatsächlichen Material. 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`](https://ailoot.ai/models/de-ch/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) Suno /`suno-api` ### Einstieg Suno erstellt Musik aus einer kurzen schriftlichen Idee. Der dokumentierte automatische Ablauf erzeugt zwei Songs und enthält eine Instrumentaloption; fertige Audiodateien und Metadaten der Titel werden über den Generierungsauftrag zurückgegeben. 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 | | --- | --- | --- | --- | --- | | KonfigurationToken-Basistarife | 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 · Cache schreiben · Schätzung nur zum Vergleich **—** / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich **—** / 1K Tokens | | KonfigurationPro Anfrage | Tarifstaffel— | Prognostizierte Menge— | Abrechnungsmengeeine Anfrage | Gebühr Eingabe · Schätzung nur zum Vergleich **$0.2** pro Anfrage | | KonfigurationGeschätzte Erzeugungskosten | 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 abschliessenden Verbrauchsdatensatzes. [So funktionieren Reservierung und Abrechnung →](https://ailoot.ai/docs/de-ch/billing/reserve/) ### Beispielanfragen #### Ailoot Ultra · Music curl · einmal erstellen und den Beleg speichernDen ursprünglichen Auftrag auslesenJedes fertiggestellte eigene Asset speichern ```bash 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. ``` ```bash 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 ``` ```bash 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 samt Headern, ursprünglichen Kennungen, jeder tatsächlichen Ausgabe sowie sämtlichen Verbrauchs- und Abrechnungsfeldern auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede Rolle auf, die darauf verweist. ##### Wenn die ursprüngliche Antwort geprüft werden muss Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-id und sämtliche Header auf. Lesen Sie ausschliesslich 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`](https://ailoot.ai/models/de-ch/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) #### Aliasnamen für Methodenpfade Verwenden Sie die oben angezeigten Methodenpfade. #### Zugehörige Aufrufer-IDs [`suno-api`](https://ailoot.ai/models/de-ch/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) 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` Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung. ## Das Unternehmen und sein Projektportfolio Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe. ## Tokens mit Rabatt kaufen. Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf. Abo Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen. Aktionscode bis 50% Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet. Ausgaben in der Historie Modell, Tokens und Betrag werden für jede Anfrage gespeichert. [Abo wählen](https://ailoot.ai/docs/de-ch/billing/subscriptions/) · [Modellpreise ansehen](https://ailoot.ai/models/de-ch/) ## Verbinden Sie die API mit dem Produkt, das Sie verkaufen. SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an. Kommerzielle Anwendung Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes. Reseller-Lizenz Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an. Dokumente auf der Website Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich. [Reseller-Lizenz anfordern](mailto:support@ailoot.ai) · [Offizielles Angebot und Lizenzvertrag](https://ailoot.ai/legal/offer?lang=de-ch) ## Ailoot · Das Unternehmen und sein Projektportfolio Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle. Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe. Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.