API-Dokumentation

API-Schlüssel abrufen und speichern

Die Authentifizierung gehört auf Ihren Anwendungsserver. Speichern Sie Produktionsschlüssel nie im Browsercode, in mobilen Bundles, Logs oder öffentlichen Repositories.

1. 1Erstellen Sie ein Konto und öffnen Sie den API-Schlüsselbereich im Dashboard.
2. 2Kopieren Sie den Schlüssel und speichern Sie ihn im Secret Manager oder in einer geschützten Serverumgebung.
3. 3Senden Sie ihn im Authorization-Header als Bearer-Token und ersetzen Sie offengelegte Schlüssel sofort.

Schnellstart

Erstellen Sie einen asynchronen Musikauftrag, speichern Sie die zurückgegebene workId und fragen Sie den feed-Endpunkt bis zum Abschluss ab. Nach Setzen des Serverschlüssels ist die Anfrage ausführbar.

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

Die Dateien verwenden UDIOAPI_KEY, begrenztes Polling und strukturierte Fehler ohne externe Abhängigkeiten. Entfernen Sie vor einer GitHub-Veröffentlichung alle Geheimnisse.

API-Endpunkte

Verwenden Sie /v2/generate als Standard-Endpunkt für Music Generate. MiniMax ist ein eingebundener Provider über /v2/minimax/generate und nicht das Standardmodell für Musikgenerierung.

Fehlerbehandlung

Behandeln Sie HTTP-Status und strukturierten Antworttext als Teil des Integrationsvertrags. Protokollieren Sie workId und Ihre Anfrage-ID, aber nie den API-Schlüssel.

Wiederholen Sie Moderationsfehler oder andere endgültige Taskfehler nicht. Zeigen Sie fail_message oder error_message an, damit die Eingabe geändert werden kann.

Zusammenfassung der Änderungen

Kompatibilitätsrelevante API-Änderungen werden hier zusammengefasst und mit dem betroffenen Endpunkt verknüpft.