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-i2v-flash",
    "prompt": "The person turns around and smiles",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "1080p",
    "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-i2v-flash",
    "prompt": "The person turns around and smiles",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "1080p",
    "duration": 5
  }'

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

​
Authentifizierung

​
Authorization
string
erforderlich
Alle 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-i2v-flash
​
image_urls
array<string>
erforderlich
Array von Referenzbild-URLs (nur 1 Bild als Erstbild unterstützt)Unterstützt öffentlich zugängliche Bild-URLs oder Base64-Codierung (data:image/png;base64,...)Beispiel: ["https://example.com/image.jpg"]
Bildanforderungen:
  • Format: JPEG, JPG, PNG (ohne Transparenz), BMP, WEBP
  • Auflösung: Breite/Höhe im Bereich 240–8000 Pixel
  • Größe: ≤ 10 MB
​
prompt
string
Beschreibung des VideoinhaltsOptional, aber für Image-to-Video empfohlen; beschreibt erwartete Aktionen und EffekteGeben Sie Subjekt, Aktion, Kamera und Stil klar an, um bessere Ergebnisse zu erzielenBeispiel: "The person in the image smiles and waves, camera slowly zooms in"
​
negative_prompt
string
Negativer Prompt zur Beschreibung unerwünschter InhalteMaximal 500 ZeichenBeispiel: "blurry, low quality, distorted"
​
resolution
string
Standard:"1080p"
VideoauflösungOptionen:
  • 720p – HD
  • 1080p – FHD (Standard)
Standard: 1080p
Die Auflösung wirkt sich direkt auf den Preis aus, 1080p ist teurer als 720p. Das Seitenverhältnis wird durch das Eingabebild bestimmt.
​
duration
integer
Standard:"5"
Videodauer (Sekunden)Unterstützter Bereich: 2 bis 15 Sekunden (Ganzzahl)Standard: 5
​
audio
boolean
Standard:"true"
Soll Audio generiert werden?Auf true setzen: generiert automatisch passende Hintergrundmusik/Soundeffekte (Standard)Auf false setzen: gibt ein stummes Video ausStandard: true
Wird nicht unterstützt, wenn das Modell wan2.6-i2v ist.
​
audio_url
string
URL für benutzerdefiniertes Audio (wav/mp3, 3–30 Sekunden, ≤ 15 MB)Niedrigere Priorität als audio: wird ignoriert, wenn audio=falseWenn das Audio länger als die Videodauer ist, wird es zugeschnitten; wenn kürzer, ist der verbleibende Teil stumm
Anforderungen an die Audiodatei:
  • Format: wav, mp3
  • Dauer: 3–30 Sekunden
  • Größe: ≤ 15 MB
​
prompt_extend
boolean
Standard:"true"
Soll die intelligente Prompt-Umschreibung aktiviert werden?Verbessert die Ergebnisse für kürzere Prompts deutlich, erhöht aber die VerarbeitungszeitStandard: true
​
shot_type
string
Aufnahmetyp, erfordert prompt_extend=trueOptionen:
  • single – Einzelaufnahme (Standard), gibt ein kontinuierliches Video mit einer Aufnahme aus
  • multi – Mehrfachaufnahme, gibt ein narratives Video mit mehreren Aufnahmeübergängen aus
shot_type hat höhere Priorität als prompt. Auch wenn der Prompt „multi-shot” erwähnt, wird bei single dennoch eine Einzelaufnahme ausgegeben.
​
seed
integer
Zufallsseed (≥ 0); die Angabe desselben Seeds kann ähnliche Ergebnisse reproduzierenBeispiel: 12345
​
watermark
boolean
Standard:"false"
Soll ein „AI Generated”-Wasserzeichen hinzugefügt werden (unten rechts)?Standard: false

​
Audiosteuerung

ParameterkombinationErgebnis
Kein audio oder audio_urlAutomatisch generiertes Audio (Standard)
audio_url: "https://..."Angegebenes Audio verwenden
audio: falseStummes Video
audio: false + audio_url: "..."Stummes Video (audio hat höhere Priorität)

​
Antwort

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

​
Anwendungsfälle

​
Fall 1: Minimale Anfrage

{
  "model": "wan2.6-i2v-flash",
  "image_urls": ["https://example.com/image.jpg"]
}

​
Fall 2: Vollständige Parameter

{
  "model": "wan2.6-i2v-flash",
  "prompt": "The person in the image smiles and waves, camera slowly zooms in",
  "image_urls": ["https://example.com/image.jpg"],
  "negative_prompt": "blurry, low quality, distorted",
  "resolution": "1080p",
  "duration": 10,
  "seed": 12345,
  "prompt_extend": true,
  "shot_type": "multi",
  "audio": true,
  "watermark": false
}

​
Fall 3: Benutzerdefiniertes Audio

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Person dancing to the music",
  "image_urls": ["https://example.com/dancer.jpg"],
  "audio_url": "https://example.com/music.mp3",
  "resolution": "1080p",
  "duration": 10
}

​
Fall 4: Stummes Video

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Flower slowly blooming",
  "image_urls": ["https://example.com/flower.jpg"],
  "audio": false,
  "resolution": "720p",
  "duration": 5
}

​
Fall 5: Effektvorlage

{
  "model": "wan2.6-i2v-flash",
  "image_urls": ["https://example.com/person.jpg"],
  "template": "flying",
  "resolution": "720p"
}

​
Fall 6: Base64-Bild

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}
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.