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.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

{
  "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.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

{
  "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.7-videoedit
​
video_urls
array<string>
erforderlich
Array von Quellvideo-URLs zur Bearbeitung
Es wird nur das 1. Video verwendet
Videobeschränkungen:
  • Format: mp4, mov
  • Dauer: 2–10s
  • Auflösung: Breite und Höhe im Bereich [240, 4096] Pixel
  • Seitenverhältnis: 1:8 – 8:1
  • Dateigröße: bis zu 100 MB
​
prompt
string
Bearbeitungsanweisung, die die gewünschten Änderungen beschreibt, bis zu 5000 Zeichen
Wenn weggelassen, führt das Modell standardmäßig einen Stiltransfer durch
Beispiel: "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
​
negative_prompt
string
Negativer Prompt zur Beschreibung unerwünschter Inhalte, bis zu 500 Zeichen
​
image_urls
array<string>
Array von Referenzbild-URLs, bis zu 4 BilderWird verwendet, um den Zielstil oder das Zielaussehen festzulegen (z. B. Referenzstil für Stiltransfer)
​
resolution
string
Standard:"1080P"
Auflösung des AusgabevideosOptionen:
  • 720P – Standard
  • 1080P – Hohe Auflösung (Standard)
​
duration
integer
Standard:"0"
Dauer des Ausgabevideos (Sekunden)
  • 0 (Standard): vollständige Dauer des Originalvideos beibehalten
  • Ganzzahl zwischen 2-10: die angegebene Dauer ab Beginn übernehmen
Bei duration=0 erfolgt die Abrechnung nach der tatsächlichen Dauer des AusgabevideosDie angegebene Dauer darf die Dauer des Originalvideos in video_urls nicht überschreiten
​
size
string
Seitenverhältnis der AusgabeUnterstützte Formate:
  • 16:9 – Querformat Breitbild
  • 9:16 – Hochformat
  • 1:1 – Quadrat
  • 4:3 – Querformat
  • 3:4 – Hochformat
Wenn weggelassen, entspricht das Seitenverhältnis dem des Eingabevideos
​
prompt_extend
boolean
Standard:"true"
Soll die intelligente Prompt-Umschreibung aktiviert werden?Verbessert die Ergebnisse für kurze Prompts deutlich, erhöht aber die VerarbeitungszeitStandard: true
​
watermark
boolean
Standard:"false"
Soll dem generierten Video ein „AI Generated”-Wasserzeichen hinzugefügt werden?
  • true: Wasserzeichen hinzufügen
  • false: kein Wasserzeichen (Standard)
​
seed
integer
Ganzzahliger Seed zur Steuerung der Zufälligkeit des generierten InhaltsWertebereich: Ganzzahl ≥ 0
  • Bei identischen Anfragen erzeugt das Modell unterschiedliche Ergebnisse, wenn unterschiedliche Seed-Werte empfangen werden (z. B. ohne Seed)
  • Bei identischen Anfragen erzeugt das Modell ähnliche Ergebnisse, wenn derselbe Seed-Wert empfangen wird, eine exakte Übereinstimmung ist jedoch nicht garantiert
​
metadata
object
Objekt mit zusätzlichen Parametern

​
Antwort

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

​
Anwendungsfälle

​
Fall 1: Grundlegende Videobearbeitung (am einfachsten)

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "Replace the background with a snowy mountain scene"
}

​
Fall 2: Stiltransfer (mit Referenzbild)

{
  "model": "wan2.7-videoedit",
  "prompt": "Transfer the video style to the anime style of the reference image",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
Fall 3: Originalton des Videos beibehalten

Geeignet für Videos mit wichtigen Hintergrundgeräuschen oder Dialogen: 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "Replace the background with a mountain path",
  "metadata": { "audio_setting": "origin" }
}

​
Fall 4: Vollständige Parameter

{
  "model": "wan2.7-videoedit",
  "prompt": "Change the character's outfit to a red gown",
  "negative_prompt": "blurry, distorted",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
Audiobehandlung

audio_settingBeschreibungGeeignete Szenarien
auto (Standard)KI generiert passendes Audio basierend auf dem bearbeiteten Videoinhalt neuGrößere visuelle Stiländerungen, bei denen das Audio entsprechend aktualisiert werden soll
originOriginale Audiospur des Videos erzwungen beibehaltenVideos mit wichtiger Hintergrundmusik oder Dialogen
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.