MiniMax

MiniMax Music 1.5

minimax-music-1.5

Text-zu-Musik-Modell, das aus einer Stilbeschreibung und Liedtexten in einem Durchgang einen vollständigen Song mit Gesang und Begleitung erzeugt; ein Song kann bis zu etwa 4 Minuten lang sein und lässt sich mit Struktur-Tags in Abschnitte gliedern

minimax-music-1.5

minimax-music-1.5 ausprobieren

Eingabe

Lyrics

Galerie

Alle Arbeiten ansehen

Ausgabe

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

minimax-music-1.5 per song

Einzelpreis	$0.070

Positionierung und Kurzprofil

minimax-music-1.5 ist ein Text-zu-Musik-Modell von MiniMax, das über die einheitliche Schnittstelle von HiAPI.ai aufgerufen wird. Gibt man einen Stil-Prompt und einen Songtext mit Struktur-Tags ein, erzeugt das Modell einen vollständigen Song mit Gesang und mehrschichtiger Instrumentierung; Arrangement, Mischung und Gesang übernimmt das Modell, sodass Creators weder selbst spielen noch aufnehmen müssen. Geeignet für die Vertonung von Videos und Kurzserien, die fertige Songs benötigen, für Demos virtueller Künstler sowie für Entwickler ohne musikalische Produktionserfahrung, die schnell Songs nach Stimmung oder Szene erstellen möchten.

Kernhighlights

Songstruktur direkt über den Songtext festlegen – Der Songtext unterstützt Struktur-Tags wie [intro][verse][chorus][bridge][outro], sodass Inhalte pro Abschnitt zugewiesen werden und die Übergänge zwischen den Abschnitten des generierten Stücks kohärenter werden.
Stil und Stimmung über Prompts steuern – Stil-Prompts beschreiben Genre, Stimmung und Instrumentierung; das Modell übernimmt darauf basierend Arrangement und Gesang, wodurch manuelles Feintuning reduziert wird.
Ausgabespezifikationen nach Bedarf festlegen – Unterstützt die Auswahl der Formate mp3, wav und pcm sowie die Angabe von Abtastrate und Bitrate, passend für nachgelagerte Wiedergabe- oder Schnitt-Pipelines.

Funktionsbeschreibung

Songtextgesteuerte Ganzsong-Generierung: Übergibt man einen Songtext mit 10–600 Zeichen und einen Stil-Prompt mit 10–300 Zeichen, erzeugt das Modell in einem Durchgang einen Song mit Gesang und Begleitung; Entwickler erhalten direkt eine nutzbare Audiodatei.

Abschnitte über Struktur-Tags anordnen: Mit Tags wie [intro][verse][chorus] im Songtext werden Abschnitte unterteilt, sodass Position und Wiederholungsbeziehungen von Strophe und Refrain klar sind und die Kohärenz der fertigen Songform erhöht wird.

Stil- und Stimmungskontrolle per Text: Über Prompts lassen sich Genre, Stimmung und Instrumentierung beschreiben, passend für Vertonungsanforderungen unterschiedlicher Themen, ohne für jeden Stil ein anderes Modell zu verwenden.

Ausgabeparameter für Audio wählbar: In der Anfrage lassen sich Audioformat, Abtastrate und Bitrate angeben, um Dateien in der von Downstream-Playern oder Postproduktionsprozessen geforderten Spezifikation auszugeben.

Anwendungsfälle

Vertonung für Kurzvideo- und Kurzserien-Creators – Passend zur Stimmung der Handlung einen Prompt schreiben und Songtext beifügen, um einen Titelsong oder Zwischensong mit Gesang zu erzeugen, der direkt für Videoschnitt und Veröffentlichung genutzt wird.
Song-Demos für Betreiber virtueller Künstler – Mit Stil-Prompt und Songtext schnell vollständige Gesangsstücke produzieren, die als Werke virtueller Sänger oder als Demo-Material für die Außendarstellung dienen.
Schnelle Songerstellung für Creators ohne Musikbackground – Es genügen eine Beschreibung von Stimmung oder Szene und ein selbst geschriebener Songtext, um einen fertig arrangierten und gemischten Song für Content-Veröffentlichung oder Veranstaltungen zu erhalten.

Einschränkungen und Auswahlhinweise

Es werden ausschließlich Songs auf Basis vom Nutzer bereitgestellter Songtexte generiert; eine automatische Textdichtung wird nicht angeboten. Auch ein reiner Instrumentalmodus wird nicht unterstützt; für Begleitung ohne Gesang sollte ein anderes Modell gewählt werden. Der Songtext ist auf 600 Zeichen begrenzt; bei langen oder mehrteiligen komplexen Arrangements ist eine Kürzung und Auswahl nötig. Das Ergebnis hängt von der Qualität von Prompt und Songtext ab; die Verwendung von Struktur-Tags zur Abschnittsgliederung wird empfohlen. Wer erweiterte Steuerungsmöglichkeiten benötigt, kann eine höhere Version derselben Serie in Betracht ziehen.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: minimax-music-1.5

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für minimax-music-1.5 und Route default — siehe Parametertabelle unten.

lyricsstringPflichtminLength 10maxLength 600

Songtext, ein Satz pro Zeile (getrennt durch \n), Länge zwischen 10 und 600 Zeichen, unterstützt Struktur-Tags [intro][verse][chorus][bridge][outro].

promptstringPflichtminLength 10maxLength 300

Text-Prompt zur Steuerung des Musikstils, beschreibt Genre, Stimmung und Instrumentierung, Länge zwischen 10 und 300 Zeichen.

bitrateintegerOptionalStandard: 256000

Bitrate des Ausgabaaudios in bps, Standard 256000.

Optionen:3200064000128000256000

sample_rateintegerOptionalStandard: 44100

Abtastrate des Ausgabaaudios in Hz, Standard 44100.

Optionen:16000240003200044100

audio_formatstringOptionalStandard: "mp3"

Ausgabe-Audioformat, Standard mp3.

Optionen:mp3wavpcm

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-music-1.5",
  "input": {
    "lyrics": "…",
    "prompt": "…",
    "bitrate": 256000,
    "sample_rate": 44100,
    "audio_format": "mp3"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-music-1.5",
    input: {
      "lyrics": "…",
      "prompt": "…",
      "bitrate": 256000,
      "sample_rate": 44100,
      "audio_format": "mp3"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-music-1.5",
        "input": {
          "lyrics": "…",
          "prompt": "…",
          "bitrate": 256000,
          "sample_rate": 44100,
          "audio_format": "mp3"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}