Zum Hauptinhalt springen
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
Autorisierung

​
Authorization
string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungAPI-Key abrufen:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API-Key zu erhaltenFügen Sie ihn zum Request-Header hinzu:
Authorization: Bearer YOUR_API_KEY

​
Anfrageparameter

​
model
string
erforderlich
Unterstützte Modelle:
  • MiniMax-Hailuo-2.3 – Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast – Hailuo 2.3 Fast (geringere Latenz)
MiniMax-Hailuo-2.3-Fast:
Für dieses Modell ist first_frame_image erforderlich.
​
prompt
string
erforderlich
Beschreibung des Videoinhalts (max. 2000 Zeichen)Beschreiben Sie Szenen, Aktionen und Stile detailliert für bessere Generierungsergebnisse. Unterstützt Kamerabewegungs-Befehle (siehe Abschnitt „Kamerabewegungs-Befehle” weiter unten).Beispiel: "A cute kitten running on the grass"
​
duration
integer
Standard:"6"
Videodauer (Sekunden)Optionen:
  • 6 – 6-Sekunden-Video
  • 10 – 10-Sekunden-Video
Standard: 6
1080p-Einschränkung: Bei 1080p-Auflösung wird nur eine Dauer von 6 Sekunden unterstützt
​
resolution
string
Standard:"768p"
VideoauflösungOptionen:
  • 768p – Hohe Auflösung
  • 1080p – Full HD (nur 6 Sekunden Dauer)
Standard: 768p
​
first_frame_image
string
Erstes Einzelbild des VideosZwei Formate werden unterstützt:
  • Öffentliche URL: https://example.com/start.jpg
  • Base64-codiert: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Wenn angegeben, wird dieses Bild als Anfangsbild des Videos verwendet
MiniMax-Hailuo-2.3-Fast:
Für dieses Modell ist first_frame_image erforderlich.
​
prompt_optimizer
boolean
Standard:"true"
Soll der Prompt automatisch optimiert werden?Bei Aktivierung optimiert das System Ihren Prompt automatisch für bessere GenerierungsergebnisseStandard: true
​
fast_pretreatment
boolean
Standard:"false"
Soll die Optimierungszeit verkürzt werden?Bei Aktivierung ist die Verarbeitung schneller, aber die Optimierungsqualität kann leicht beeinträchtigt seinStandard: false
​
watermark
boolean
Standard:"false"
Soll ein Wasserzeichen hinzugefügt werden?Standard: false

​
Auflösungs- und Dauerkombinationen

AuflösungUnterstützte DauerAnmerkungen
768p6s, 10sVollständig unterstützt
1080p6s10s nicht unterstützt

​
Kamerabewegungs-Befehle

Verwenden Sie die Syntax [Befehl] im prompt, um Kamerabewegungen zu steuern. 15 Befehle werden unterstützt:
KategorieBefehle
Schwenk[左移] (links schwenken) [右移] (rechts schwenken)
Horizontale Drehung[左摇] (links drehen) [右摇] (rechts drehen)
Heran-/Wegfahren[推进] (heranfahren) [拉远] (wegfahren)
Vertikale Bewegung[上升] (aufsteigen) [下降] (absteigen)
Vertikale Drehung[上摇] (nach oben neigen) [下摇] (nach unten neigen)
Zoom[变焦推近] (heranzoomen) [变焦拉远] (wegzoomen)
Sonstiges[晃动] (wackeln) [跟随] (folgen) [固定] (statisch)
Anwendungsbeispiel: 
{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]A cat running in the garden, camera slowly pushing in for a close-up"
}

​
Antwort

​
code
integer
Statuscode der Antwort, 200 bei Erfolg
​
data
array
Datenarray der Antwort

​
Anwendungsfälle

​
Fall 1: Schnelle Text-zu-Video-Generierung

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "A cute kitten running on the grass, sunny day"
}

​
Fall 2: Hochwertiges 1080p-Video

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "City nightscape, neon lights flickering, traffic flowing",
  "duration": 6,
  "resolution": "1080p",
  "prompt_optimizer": true,
  "watermark": false
}

​
Fall 3: Bild-zu-Video mit erstem Einzelbild

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Kitten running towards camera, smiling and blinking",
  "first_frame_image": "https://example.com/cat.jpg",
  "duration": 6,
  "resolution": "1080p"
}

​
Fall 4: Kamerabewegungs-Befehle

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]A cat running in the garden, camera slowly pushing in for a close-up",
  "duration": 6,
  "resolution": "768p"
}

​
Fall 5: Schneller Vorverarbeitungsmodus

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Waves crashing on the beach at sunset",
  "duration": 10,
  "resolution": "768p",
  "prompt_optimizer": true,
  "fast_pretreatment": true
}
Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die nach der Übermittlung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Generierungsfortschritt und die Ergebnisse abzufragen.