Mehr

Einstellungen

API-Dokumentation

Verwenden Sie Ihren API-Schlüssel, um Musik zu generieren, Audio zu erweitern, Stems zu separieren und mehr über die REST-API.

Studio-Abonnement erforderlich

API-Zugriff und API-Schlüssel-Erstellung sind nur für Studio-Abonnenten verfügbar. Sie können diese Dokumentation öffentlich lesen, benötigen jedoch einen aktiven Studio-Plan, um Schlüssel zu erstellen und die API aufzurufen.

Studio-Pläne vergleichen

Authentifizierung

Alle API-Anforderungen benötigen einen Bearer-Token. Verwenden Sie Ihren API-Schlüssel im Authorization-Header.

Authorization: Bearer sk-your-api-key-here

Basis-URL

https://acestep.io

API-Schlüssel-Verwaltung

Erstellen und verwalten Sie Ihre API-Schlüssel unter Einstellungen → API-Schlüssel

Die Erstellung von API-Schlüsseln ist nur für aktive Studio-Abonnenten verfügbar.

https://acestep.io/settings/apikeys

Aufgabenstatus-Referenz

queuedsubmittedrunningprocessingcompletedfailed

API-Endpunkte

POST/api/v2/generate-audio5 / 10 Credits

Musik aus Text generieren

Erstellen Sie KI-generierte Musik aus Style-Tags und Songtexten. Unterstützt Instrumentalmodus und Studio-Qualität.

Anfragekörper

{
  "tags": "pop, energetic, synth, dance",
  "lyrics": "[Intro]\\n[Verse 1]\\n...",
  "seconds": 60,
  "steps": 12,
  "studio_quality": false
}

Antwort

// studio_quality=false: 2 normal tasks, 5 credits
{
  "code": 0,
  "data": {
    "tasks": [
      { "task_id": "83082474758221335" },
      { "task_id": "83082475022272525" }
    ],
    "credits_consumed": 5,
    "remaining_credits": 781
  }
}

// studio_quality=true: 1 studio task, 10 credits
{
  "code": 0,
  "data": {
    "tasks": [
      { "task_id": "83082478890054944" }
    ],
    "credits_consumed": 10,
    "remaining_credits": 771
  }
}
GET/api/v2/task-status/{task_id}Kostenlos Credits

Aufgabenstatus abfragen

Fragen Sie den Status jeder Generierungsaufgabe ab. Verwenden Sie die task_id, die von den Erstellungs-Endpunkten zurückgegeben wird.

Antwort

// Normal task: flat response
{
  "code": 0,
  "data": {
    "task_id": "83082474758221335",
    "status": "completed",
    "progress": 100,
    "message": "Success",
    "audio_url": "https://cdn.acestep.io/...mp3",
    "lrc": "[00:00.00][Intro]...",
    "created_at": "2026-06-05T15:54:33Z"
  }
}

// Multi-output task: each sibling carries the same fields as a normal task
{
  "code": 0,
  "data": {
    "tasks": [
      { "task_id": "xxx", "status": "completed", "progress": 100, "message": "Success", "audio_url": "https://cdn.acestep.io/...mp3", "lrc": "[00:00.00][Intro]...", "created_at": "2026-06-05T15:54:33Z" },
      { "task_id": "yyy", "status": "completed", "progress": 100, "message": "Success", "audio_url": "https://cdn.acestep.io/...mp3", "lrc": "[00:00.00][Intro]...", "created_at": "2026-06-05T15:54:33Z" }
    ]
  }
}
POST/api/v2/extend-audio5 Credits

Audiodauer erweitern

Erweitern Sie einen vorhandenen Track, indem Sie zusätzliches Audio im angegebenen Zeitbereich generieren.

Anfragekörper

{
  "srcTaskId": "source-task-id",
  "srcAudioUrl": "https://cdn.acestep.io/...mp3",
  "caption": "extend with guitar solo",
  "repaintingStart": 55,
  "repaintingEnd": 65
}

Antwort

{
  "code": 0,
  "data": {
    "task_id": "83082578055174907",
    "status": "queued",
    "credits_consumed": 5,
    "remaining_credits": 766
  }
}
POST/api/v2/replace-section5 Credits

Audioabschnitt ersetzen

Ersetzen Sie einen Abschnitt eines vorhandenen Audios durch neue Inhalte (3-60 Sekunden Bereich).

Anfragekörper

{
  "srcTaskId": "source-task-id",
  "srcAudioUrl": "https://cdn.acestep.io/...mp3",
  "caption": "drum solo section",
  "repaintingStart": 20,
  "repaintingEnd": 30
}

Antwort

{
  "code": 0,
  "data": {
    "task_id": "83082581023354167",
    "status": "queued",
    "credits_consumed": 5,
    "remaining_credits": 761
  }
}
POST/api/v2/add-stem5 Credits

Instrument-Stem hinzufügen

Fügen Sie eine neue Instrumentenspur hinzu. Gültige Spuren: woodwinds, brass, fx, synth, strings, percussion, keyboard, guitar, bass, drums, backing_vocals, vocals.

Anfragekörper

{
  "srcTaskId": "source-task-id",
  "srcAudioUrl": "https://cdn.acestep.io/...mp3",
  "caption": "add keyboard layer",
  "selectedTrack": "keyboard"
}

Antwort

{
  "code": 0,
  "data": {
    "task_id": "83082714928845380",
    "status": "queued",
    "credits_consumed": 5,
    "remaining_credits": 731
  }
}
POST/api/v2/cover-audio5 Credits

Cover-Version erstellen

Generieren Sie eine Cover-Version eines vorhandenen Audios mit neuem Stil und neuen Songtexten.

Anfragekörper

{
  "srcTaskId": "source-task-id",
  "srcAudioUrl": "https://cdn.acestep.io/...mp3",
  "caption": "acoustic cover version"
}

Antwort

{
  "code": 0,
  "data": {
    "task_id": "83082589527341345",
    "status": "queued",
    "credits_consumed": 5,
    "remaining_credits": 746
  }
}
POST/api/v2/generate-lyricsKostenlos Credits

Songtexte generieren

Generieren Sie Songtexte und Style-Tags aus einem Thema mit KI. Kostenlos, keine Credits erforderlich.

Anfragekörper

{
  "theme": "a lonely astronaut floating in deep space"
}

Antwort

{
  "code": 0,
  "data": {
    "tags": "cinematic, ambient, melancholic...",
    "lyrics": "[Intro]\\n(Ethereal synth pads...)..."
  }
}
GET/api/v2/download-audio/{task_id}Kostenlos Credits

Audio herunterladen

Laden Sie die generierte Audiodatei als Anhang herunter.

Antwort

Binärer Audio-Stream (audio/mpeg)