API-Referenz

Musik

Modelle für diesen Endpunkt (1)

POST/v1/music/generations

GET/v1/music/tasks/{task_id}

GET/v1/music/tasks/{task_id}/content

Asynchrone Musikgenerierung für Songs und Instrumentals. Das Einreichen gibt sofort eine task_id zurück; fragen Sie den Task ab oder empfangen Sie einen Webhook-Callback, und lesen Sie dann das fertige Audio über /content.

#Anfrageparameter

modelstringerforderlich
Eine Musik-Modell-ID von der Modellseite, z. B. suno.
promptstringerforderlich
Beschreiben Sie Song, Stimmung, Instrumentierung oder die Richtung des Songtexts.
titlestringoptional
Optionaler Tracktitel, der an Modellfamilien weitergegeben wird, die ihn unterstützen.
tagsstring | arrayoptional
Optionale Genre- oder Stilhinweise wie cinematic, pop oder ambient.
versionstringoptional
Versionsschalter der Modellfamilie, wenn der Anbieter mehrere Generationen anbietet.
mvstringoptional
Anbieterspezifische Auswahl des Musikmodus; serverseitig belassen, sofern Nutzer keine explizite Kontrolle brauchen.
instrumentalbooleanoptional
Instrumentale Ausgabe ohne Gesang erzeugen, sofern das Modell es unterstützt.
make_instrumentalbooleanoptional
Alternatives Anbieter-Flag für instrumentale Ausgabe; manche Anbieter nutzen es statt instrumental.
continue_clip_idstringoptional
Einen früheren Clip fortsetzen oder verlängern, statt einen neuen Track zu beginnen.
continue_atnumberoptional
Startpunkt in Sekunden für Fortsetzungen.
webhook_urlstringoptional
HTTPS-URL, die aufgerufen wird, sobald der Task einen Endzustand erreicht.
webhook_secretstringoptional
Wenn gesetzt, enthalten Zustellungen X-Xiaoxiang-Signature: sha256=hex(HMAC-SHA256(body, secret)).

Einfach anfangen

Für die meisten Produkte reicht prompt für die erste Integration. title, tags, version und die Fortsetzungsfelder sind erweiterte Optionen, die Sie erst hinzufügen sollten, wenn das Produkt sie klar braucht.

Derselbe asynchrone Vertrag wie bei anderen Medien-Tasks

Musik folgt demselben Muster Einreichen → Abfragen oder Webhook → /content wie Bild- und Video-Tasks, daher kann ein Backend-Task-Runner meist alle drei abdecken.

#Zugehörige Fehler

404 not_foundUnbekannter Pfad, unbekannter Modellname oder eine abgelaufene bzw. fremde task_id.
422 unprocessable_entityDer Anbieter hat vom Gateway weitergeleitete Parameterwerte abgelehnt (z. B. nicht unterstützte Größe oder Dauer).
401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

# submit
curl https://www.aisplice.store/v1/music/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno",
    "prompt": "a warm cinematic piano theme",
    "instrumental": true
  }'

# poll every 5s
curl https://www.aisplice.store/v1/music/tasks/$TASK_ID -H "Authorization: Bearer sk-YOUR_KEY"

# fetch the finished track
curl -L https://www.aisplice.store/v1/music/tasks/$TASK_ID/content \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -o song.mp3

#Antwort

response.json

// POST — submit accepted
{"task_id": "task_xxx", "status": "queued"}

// GET /v1/music/tasks/{task_id}
{
  "task_id": "task_xxx",
  "status": "in_progress",
  "progress": "42%"
}

// GET /v1/music/tasks/{task_id}/content
{
  "task_id": "task_xxx",
  "status": "completed",
  "metadata": {
    "audio_url": "https://…",
    "lyric": "…"
  }
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückVideos Weiter3D-Modelle