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": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "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": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "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
Name des Videogenerierungsmodells, fest auf wan2.6
​
prompt
string
erforderlich
Beschreibung des VideoinhaltsErforderlich im Text-to-Video-Modus. Beschreiben Sie Szenen, Aktionen und Stile detailliert für bessere ErgebnisseBeispiel: "A cute cat stretching in the sunlight"
​
image_urls
array<url>
Array von Referenzbild-URLs (nur 1 Bild unterstützt)Erforderlich im Image-to-Video-Modus. Unterstützt öffentlich zugängliche Bild-URLsBeispiel: ["https://example.com/image.jpg"]
Das System wählt automatisch den Text-to-Video- oder Image-to-Video-Modus basierend darauf, ob image_urls enthalten ist
​
negative_prompt
string
Negativer Prompt zur Beschreibung unerwünschter InhalteBeispiel: "blurry, low quality, distorted"
​
aspect_ratio
string
Standard:"16:9"
Seitenverhältnis des VideosOptionen:
  • 16:9 – Querformat (Standard)
  • 9:16 – Hochformat
  • 1:1 – Quadrat
  • 4:3 – Querformat
  • 3:4 – Hochformat
Standard: 16:9
Nicht unterstützt im Image-to-Video-Modus
​
resolution
string
Standard:"720p"
VideoauflösungOptionen:
  • 720p – Standard (Standard)
  • 1080p – Hohe Auflösung
Standard: 720p
Die Auflösung 480p wird nicht unterstützt
Abrechnung pro Sekunde. Der Preis variiert je nach Auflösung. Konkrete Preise finden Sie im Modellkatalog
​
duration
integer
Standard:"5"
Videodauer (Sekunden)Unterstützte Werte: nur 5, 10, 15 SekundenStandard: 5
​
seed
integer
Zufallsseed für reproduzierbare ErgebnisseBeispiel: 12345
​
prompt_extend
boolean
Soll der Prompt automatisch erweitert werden?Bei Aktivierung optimiert und bereichert das System Ihren Prompt automatisch
​
audio
boolean
Soll automatisch Audio hinzugefügt werden?Bei Aktivierung generiert das System passendes Audio für das Video
​
audio_url
string
URL des angegebenen AudiosHat Vorrang vor dem Parameter audio
Die Audiodauer darf die Videodauer nicht überschreiten. Wenn das Audio kürzer als die Videodauer ist, hat der erste Teil des Videos Ton, während der Rest stumm ist.
​
shot_type
string
AufnahmetypOptionen:
  • single – Einzelaufnahme
  • multi – Mehrere Aufnahmen
​
watermark
boolean
Soll ein Wasserzeichen hinzugefügt werden?
​
template
string
Name der Effektvorlage für den Image-to-Video-Spezialeffektmodus
Bei Verwendung des Effektmodus:
  • Nur ein Bild ist erforderlich (über image_urls übergeben)
  • Kein Prompt nötig (das Modell ignoriert das prompt-Feld)
Allgemeine Effekte:
  • squish – Drücken & Quetschen
  • rotation – Rotation
  • poke – Stupsen
  • inflate – Ballonaufblasen
  • dissolve – Molekulare Auflösung
  • melt – Hitzewellen-Schmelze
  • icecream – Eiscreme-Planet
  • flying – Magische Levitation
Effekte für eine Person:
  • carousel – Zeit-Karussell
  • singleheart – Love You
  • dance1 – Swing-Moment
  • dance2 – Tanzbewegung
Weitere Effekte finden Sie in der Alibaba Wanxiang Vorlagen-Dokumentation

​
Auflösungs- und Seitenverhältnis-Kombinationen

SeitenverhältnisBeschreibung720p-Größe1080p-Größe
16:9Querformat (Standard)1280×7201920×1080
9:16Hochformat720×12801080×1920
1:1Quadrat960×9601440×1440
4:3Querformat1088×8321632×1248
3:4Hochformat832×10881248×1632

​
Antwort

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

​
Anwendungsfälle

​
Fall 1: Text-zu-Video (einfache Anfrage)

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

​
Fall 2: Text-zu-Video (vollständige Parameter)

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

​
Fall 3: Bild-zu-Video

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.apimart.ai/f/apimart-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

​
Fall 4: Bild-zu-Video (Base64-Bild)

{
  "model": "wan2.6",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
Modusbeschreibung

​
Text-zu-Video (Text-to-Video)

  • Parameter prompt ist erforderlich
  • Parameter image_urls wird nicht benötigt

​
Bild-zu-Video (Image-to-Video)

  • Parameter image_urls ist erforderlich (nur 1 Bild unterstützt)
  • Parameter prompt ist optional, dient zur Beschreibung erwarteter Aktionen
Das System wählt den Modus automatisch basierend darauf, ob image_urls in der Anfrage enthalten ist
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.