API v1

FM9 API-Dokumentation

Erstellen Sie leistungsstarke Musikgenerierungsfunktionen in Ihren Anwendungen mit unserer REST-API.

Schnellstart

Generieren Sie Ihren ersten Track mit einem einzigen API-Aufruf.

Requestbash

curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "fröhliche elektronische Tanzmusik"}'

Responsejson

{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

Authentifizierung

Alle API-Anfragen erfordern einen API-Schlüssel. Fügen Sie Ihren Schlüssel im Authorization-Header ein:

Holen Sie sich Ihren API-Schlüssel vom Entwickler-Dashboard.

Authorization: Bearer YOUR_API_KEY

Endpunkte

POST/v1/generate

Musik Generieren

Erstellt eine neue Musikgenerierungsaufgabe.

Parameters

prompt-Textbeschreibung der zu generierenden Musik (erforderlich)
duration-Tracklänge in Sekunden (30-180, Standard: 60)
style-Musikstil-Preset (optional)
instrumental-Ob nur Instrumental generiert werden soll (Standard: false)

Gibt ein Generierungsobjekt mit Task-ID und Status zurück.

GET/v1/generation/:id

Generierungsstatus Abrufen

Überprüft den Status einer Generierungsaufgabe.

Gibt das Generierungsobjekt mit aktuellem Status und Download-URLs bei Fertigstellung zurück.

GET/v1/generations

Generierungen Auflisten

Ruft eine Liste Ihres Generierungsverlaufs ab.

Parameters

limit-Anzahl der zurückzugebenden Ergebnisse (Standard: 20, max: 100)
offset-Paginierungs-Offset (Standard: 0)
status-Nach Status filtern (pending, processing, completed, failed)

API-Preise

Einfache, transparente nutzungsbasierte Preisgestaltung.

Starter

Kostenlos

10 Generierungen/Monat

Basis-API-Zugang
Standardqualität
Community-Support

Entwickler

49 $/mo

500 Generierungen/Monat

Voller API-Zugang
Hochwertige Ausgabe
Prioritäts-Support
Webhook-Callbacks

Enterprise

Individuell

Unbegrenzt

Dedizierte Infrastruktur
Benutzerdefinierte Modelle
SLA-Garantie
24/7-Support

Rate-Limits

Um eine faire Nutzung und Servicestabilität zu gewährleisten, gelten folgende Rate-Limits:

Starter: 10 Anfragen/Minute
Entwickler: 60 Anfragen/Minute
Enterprise: Benutzerdefinierte Limits

Bei Überschreitung des Rate-Limits erhalten Sie eine 429 Too Many Requests Antwort.

Fehlercodes

Die API verwendet Standard-HTTP-Antwortcodes, um Erfolg oder Fehler anzuzeigen.

Code	Description
400	Bad Request - Ungültige Parameter
401	Unauthorized - Ungültiger oder fehlender API-Schlüssel
402	Payment Required - Unzureichende Credits
429	Too Many Requests - Rate-Limit überschritten
500	Internal Server Error - Auf unserer Seite ist etwas schiefgelaufen

Brauchen Sie Hilfe?

Unser Entwickler-Support-Team ist für Sie da.

E-Mail: [email protected]

Vollständige Dokumentation verfügbar unter docs.fm9.ai