> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan2.7 Videobearbeitung > - Das WAN2.7 (wan2.7-video-edit)-Modell unterstützt Video-Bearbeitung für **anweisungsbasierte Bearbeitung** und **Video-Übertragung** - **Erforderlich:** genau 1 Video hochladen (`video_urls`); optional bis zu 4 Referenzbilder (`image_urls`) - Zwei Anwendungsmuster: - **Reine Anweisungsbearbeitung:** `video_urls` + `prompt` (z. B. Stiländerung, Outfit-Wechsel) - **Anweisung + Referenzbild:** `video_urls` + `image_urls` + `prompt` (z. B. lokales Ersetzen mit Elementen aus dem Referenzbild) - Audio-Verarbeitung: gesteuert über `keep_original_sound` (`true` behält Originalton; `false` lässt das Modell das Audio intelligent verarbeiten) - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Task-ID für die [Statusabfrage](/de/api-manual/task-management/get-task-detail) - Generierte Videolinks sind 24 Stunden gültig, bitte zeitnah speichern - **Abrechnung:** erfolgt nach "Eingabe-Videodauer + Ausgabe-Videodauer"; nur erfolgreiche Generierungen werden abgerechnet, fehlgeschlagene Aufgaben sind kostenlos ## OpenAPI ````yaml de/api-manual/video-series/wan2.7/wan2.7-video-edit.json POST /v1/videos/generations openapi: 3.1.0 info: title: wan2.7-video-edit API description: >- Bearbeiten Sie Videos mit dem WAN2.7-Modell, unterstützt das Hochladen von Videos und die Bearbeitung mit Referenzbildern license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] paths: /v1/videos/generations: post: tags: - Videogenerierung summary: wan2.7-video-edit API description: >- - Das WAN2.7 (wan2.7-video-edit)-Modell unterstützt Video-Bearbeitung für **anweisungsbasierte Bearbeitung** und **Video-Übertragung** - **Erforderlich:** genau 1 Video hochladen (`video_urls`); optional bis zu 4 Referenzbilder (`image_urls`) - Zwei Anwendungsmuster: - **Reine Anweisungsbearbeitung:** `video_urls` + `prompt` (z. B. Stiländerung, Outfit-Wechsel) - **Anweisung + Referenzbild:** `video_urls` + `image_urls` + `prompt` (z. B. lokales Ersetzen mit Elementen aus dem Referenzbild) - Audio-Verarbeitung: gesteuert über `keep_original_sound` (`true` behält Originalton; `false` lässt das Modell das Audio intelligent verarbeiten) - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Task-ID für die [Statusabfrage](/de/api-manual/task-management/get-task-detail) - Generierte Videolinks sind 24 Stunden gültig, bitte zeitnah speichern - **Abrechnung:** erfolgt nach "Eingabe-Videodauer + Ausgabe-Videodauer"; nur erfolgreiche Generierungen werden abgerechnet, fehlgeschlagene Aufgaben sind kostenlos operationId: createWan27VideoEditGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27VideoEditRequest' examples: instruction_edit: summary: Reine Anweisungsbearbeitung (Stiländerung) value: model: wan2.7-video-edit prompt: Wandle die gesamte Szene in einen Knetmasse-Look um video_urls: - https://example.com/source.mp4 instruction_with_reference: summary: Anweisung + Referenzbild (lokales Ersetzen) value: model: wan2.7-video-edit prompt: >- Ersetze die Kleidung des Mädchens im Video durch die Kleidung im Referenzbild video_urls: - https://example.com/source.mp4 image_urls: - https://example.com/clothes.png responses: '200': description: Video-Aufgabe erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Nicht authentifiziert, Token ungültig oder abgelaufen content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Kontingent, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Keine Zugriffsberechtigung content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan2.7-video-edit' type: invalid_request_error '429': description: Anfragerate überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: Wan27VideoEditRequest: required: - model - video_urls type: object properties: model: type: string description: Modellname, muss `wan2.7-video-edit` sein enum: - wan2.7-video-edit example: wan2.7-video-edit prompt: type: string description: >- Textprompt zur Beschreibung des gewünschten Bearbeitungseffekts. Unterstützt Chinesisch und Englisch; jedes Zeichen/jeder Buchstabe zählt als 1, Überschuss wird automatisch gekürzt. Maximale Länge 5000 Zeichen maxLength: 5000 example: >- Ziehe der Person ein schickes Outfit an und setze ihr den Hut aus dem Referenzbild auf negative_prompt: type: string description: >- Negativprompt zur Beschreibung von Inhalten, die im Video vermieden werden sollen. Unterstützt Chinesisch und Englisch. Maximale Länge 500 Zeichen; Überschuss wird automatisch gekürzt maxLength: 500 example: Unscharf, geringe Qualität video_urls: type: array items: type: string format: uri description: |- Quell-Video-URL-Liste. **Genau 1 Video erforderlich** **Videogrenzen:** - Formate: mp4, mov - Dauer: `2 ~ 10` Sekunden - Auflösung: Breite und Höhe in `[240, 4096]` Pixel - Seitenverhältnis: 1:8 ~ 8:1 - Dateigröße: max. `100MB` minItems: 1 maxItems: 1 example: - https://example.com/source.mp4 image_urls: type: array items: type: string format: uri description: >- Referenzbild-URL-Liste, max. 4 Bilder. Verwendung für "Anweisung + Referenzbild", z. B. zum Ersetzen von Kleidung oder Requisiten durch Elemente aus einem Referenzbild **Bildgrenzen:** - Formate: JPEG, JPG, PNG (Transparenz nicht unterstützt), BMP, WEBP - Auflösung: Breite und Höhe in `[240, 8000]` Pixel - Seitenverhältnis: 1:8 ~ 8:1 - Dateigröße: max. `20MB` maxItems: 4 example: - https://example.com/ref.jpg keep_original_sound: type: boolean description: >- Audio-Verarbeitung des bearbeiteten Videos. Standard: `false` - `false`: Smart-Modus. Das Modell entscheidet anhand des `prompt`-Inhalts — wenn der Prompt Audio-Elemente erwähnt, kann das Audio neu generiert werden; sonst kann der Originalton beibehalten werden - `true`: Originalton des Eingabe-Videos erzwingen, kein Neugenerieren default: false example: true quality: type: string description: |- Videoqualität, Standard: `720p` **Optionen:** - `720p`: Standardqualität, Standardpreis (Standard) - `1080p`: Hohe Qualität, höherer Preis enum: - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: >- Seitenverhältnis des Videos (optional) **Verhalten:** - Nicht angegeben: Video wird mit einem Seitenverhältnis ähnlich dem Eingabe-Video erzeugt - Angegeben: Video wird mit dem angegebenen `aspect_ratio` erzeugt **Ausgabeauflösung pro Qualitätsstufe:** | Qualität | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | | --- | --- | --- | --- | --- | --- | | 720p | 1280×720 | 720×1280 | 960×960 | 1104×832 | 832×1104 | | 1080p | 1920×1080 | 1080×1920 | 1440×1440 | 1648×1248 | 1248×1648 | enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' example: '16:9' duration: type: number description: >- Videodauer in Sekunden **Regeln:** - Standard `0`: Eingabe-Videodauer übernehmen, **keine Kürzung** (nur setzen, wenn Sie das Eingabe-Video kürzen möchten) - Bei expliziter Angabe Bereich `2 ~ 10`: Das System kürzt das Eingabe-Video von 0s bis zur angegebenen `duration` minimum: 0 maximum: 10 default: 0 example: 0 seed: type: integer description: >- Zufallsseed, standardmäßig zufällig **Hinweise:** - Bereich: `1` ~ `2147483647` - Ein fester Seed reduziert beim Iterieren am Prompt die Variation und verbessert die Reproduzierbarkeit minimum: 1 maximum: 2147483647 example: 42 prompt_extend: type: boolean description: >- Ob die intelligente Prompt-Umschreibung aktiviert werden soll. Wenn aktiviert, optimiert ein großes Modell den Prompt, was die Ergebnisse für einfache oder unzureichend beschreibende Prompts deutlich verbessert. **Hinweis:** Standard ist `false` — wird der Parameter weggelassen oder `false` gesendet, erfolgt keine Umschreibung. Senden Sie explizit `true`, um die Umschreibung zu aktivieren. default: false example: true callback_url: type: string description: >- HTTPS-Callback-URL für den Aufgabenabschluss **Callback-Zeitpunkt:** - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde - Wird nach Abrechnungsbestätigung gesendet **Sicherheitseinschränkungen:** - Nur HTTPS wird unterstützt - Callbacks an interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.) - URL-Länge max. `2048` Zeichen **Callback-Mechanismus:** - Timeout: `10` Sekunden - Bis zu `3` Wiederholungen nach Fehlschlag (jeweils nach `1`/`2`/`4` Sekunden) - Callback-Antwortformat ist identisch mit der Task-Query-API - 2xx-Statuscodes gelten als erfolgreich, andere lösen Wiederholungen aus format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1757169743 id: type: string description: Aufgaben-ID example: task-unified-1757169743-7cvnl5zw model: type: string description: Tatsächlich verwendeter Modellname example: wan2.7-video-edit object: type: string enum: - video.generation.task description: Spezifischer Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Detaillierte Informationen zur Video-Aufgabe type: type: string enum: - text - image - audio - video description: Ausgabetyp der Aufgabe example: video usage: $ref: '#/components/schemas/Usage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Identifikator message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp VideoTaskInfo: type: object properties: can_cancel: type: boolean description: Ob die Aufgabe abgebrochen werden kann example: true estimated_time: type: integer description: Geschätzte Fertigstellungszeit (Sekunden) minimum: 0 example: 120 Usage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Geschätzt zu verbrauchende Credits minimum: 0 example: 5 user_group: type: string description: Benutzergruppen-Kategorie enum: - default - vip example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Alle APIs erfordern Bearer-Token-Authentifizierung ## **API-Schlüssel erhalten:** Besuchen Sie die [API-Schlüssel-Verwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Im Anfrage-Header hinzufügen:** ``` Authorization: Bearer YOUR_API_KEY ``` ````