Wan 2.7 API-Leitfaden: Text-to-Video, Image-to-Video, Reference Video & Video Edit — Vollständiges Integrationshandbuch

Zusammenfassung

• Wan 2.7 sind vier Modelle in einem Endpunkt. Text-to-Video, Image-to-Video (mit First/Last-Frame-Steuerung), Multi-Charakter-Referenzvideo (mit Voice Cloning) und instruktionsbasierte Videobearbeitung — alles über POST /v1/videos/generations.
• Preise auf EvoLink: $0.086/Sek. bei 720p, $0.144/Sek. bei 1080p. Ein 10-Sekunden-720p-Clip kostet $0.86. Keine Abonnements.
• Modell-IDs: wan2.7-text-to-video, wan2.7-image-to-video, wan2.7-reference-video, wan2.7-video-edit.
• Asynchroner Workflow. Jede Anfrage gibt sofort eine Task-ID zurück. Abfrage über GET /v1/tasks/\{task_id\}. Video-URLs laufen nach 24 Stunden ab.
• Was Wan 2.7 gegenüber Wan 2.6 auf EvoLink hinzufügt: Videobearbeitung über die Wan 2.7-Route, First-and-Last-Frame-Steuerung in I2V und Multi-Charakter-Referenzvideo mit Voice Cloning.
• Fehlgeschlagene Tasks werden nicht berechnet für Reference-Video- und Video-Edit-Modi.

Inhaltsverzeichnis

1. Schnellstart: Ihr erstes Wan 2.7-Video in 60 Sekunden
2. Die richtige Modell-ID wählen
3. Modus 1: Text-to-Video
4. Modus 2: Image-to-Video mit Frame-Steuerung
5. Modus 3: Referenzvideo mit Voice Cloning
6. Modus 4: Videobearbeitung
7. Preise und Kostenberechnung
8. Asynchroner Workflow und Task-Management
9. Fehlerbehandlung und häufige Statuscodes
10. Produktionsmuster und Sicherheitsvorkehrungen
11. Migration von Wan 2.6 auf Wan 2.7
12. Parameter-Referenz-Spickzettel
13. FAQ

1. Schnellstart: Ihr erstes Wan 2.7-Video in 60 Sekunden

Schritt 1: Video generieren

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-text-to-video",
    "prompt": "A drone shot over a misty mountain lake at sunrise, slow camera push forward, cinematic color grading",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "id": "task-unified-1757169743-7cvnl5zw",
  "status": "pending",
  "created": 1757169743
}

Schritt 2: Ergebnis abfragen

curl https://api.evolink.ai/v1/tasks/task-unified-1757169743-7cvnl5zw \
  -H "Authorization: Bearer YOUR_API_KEY"

Schritt 3: Das war's

2. Die richtige Modell-ID wählen

3. Modus 1: Text-to-Video

Funktionsweise

Generiert ein Video aus einem Textprompt. Unterstützt optionales Treiberaudio für Lippensynchronisation oder musiksynchronisierte Ausgabe. Generiert automatisch Hintergrundmusik, wenn kein Audio bereitgestellt wird.

Wichtige Parameter

Multi-Shot-Erzählung

Steuern Sie die Aufnahmestruktur direkt im Prompt:

{
  "model": "wan2.7-text-to-video",
  "prompt": "A tense detective story. Shot 1 [0-3s] wide angle: rainy night street, neon lights. Shot 2 [3-6s] medium: detective enters old building. Shot 3 [6-9s] close-up: detective's determined eyes. Shot 4 [9-12s] medium: cautious advance through dim corridor. Shot 5 [12-15s] close-up: discovers key clue.",
  "aspect_ratio": "16:9",
  "duration": 15
}

Mit Treiberaudio

{
  "model": "wan2.7-text-to-video",
  "prompt": "A cartoon general in golden armor on a horse, reciting a classical poem",
  "audio_urls": ["https://your-cdn.com/recital.mp3"],
  "duration": 10
}

4. Modus 2: Image-to-Video mit Frame-Steuerung

Funktionsweise

Drei Generierungsmodi

Gültige Eingabekombinationen

1. Nur image_start
2. image_start + audio_urls
3. image_start + image_end
4. image_start + image_end + audio_urls
5. video_urls (Fortsetzung)
6. video_urls + image_end (Fortsetzung mit Endframe)

Jede andere Kombination wird abgelehnt.

Beispiel: First-and-Last-Frame

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-to-video",
    "generation_mode": "first_last_frame",
    "prompt": "A product bottle rotating 360 degrees with soft studio lighting",
    "image_start": "https://your-cdn.com/bottle-front.jpg",
    "image_end": "https://your-cdn.com/bottle-back.jpg",
    "quality": "1080p",
    "duration": 5
  }'

Beispiel: Video-Fortsetzung

{
  "model": "wan2.7-image-to-video",
  "generation_mode": "video_continuation",
  "prompt": "The scene continues with the character walking toward the sunset",
  "video_urls": ["https://your-cdn.com/previous-clip.mp4"],
  "image_end": "https://your-cdn.com/sunset-ending.jpg",
  "duration": 5
}

5. Modus 3: Referenzvideo mit Voice Cloning

Funktionsweise

Generiert neue Videoszenen unter Beibehaltung des Erscheinungsbilds von Charakteren aus Referenzbildern oder -videos — und klont optional deren Stimme aus einer kurzen Audioaufnahme. So erstellen Sie Multi-Charakter-Videoserien, in denen jede Person über alle Episoden hinweg konsistent aussieht und klingt.

Wichtige Einschränkungen

• image_urls + video_urls kombiniert: maximal 5 Elemente insgesamt
• image_start und Stimmaudio zählen nicht zum 5-Elemente-Limit
• Dauer: 2-15 Sek. (nur Bildreferenzen), 2-10 Sek. (mit Videoreferenzen)
• Abrechnung: Eingabevideodauer + Ausgabevideodauer. Fehlgeschlagene Tasks sind kostenlos.

Charakter-Indexierung in Prompts

Verweisen Sie auf Referenzcharaktere anhand ihrer Position in den Eingabearrays:

• Englisch: Image 1, Image 2, Video 1, Video 2
• Chinesisch: 图1, 图2, 视频1, 视频2

Voice Cloning: zwei Methoden

Präzise Key-Value-Zuordnung zwischen Charakterreferenzen und Stimmaudio:

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 holds Image 2 and says: 'What lovely sunshine today'",
  "image_urls": [
    "https://your-cdn.com/girl.jpg",
    "https://your-cdn.com/toy.png"
  ],
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/girl-voice.mp3"
    }
  },
  "duration": 10
}

Beispiel: Multi-Charakter-Markenvideo

{
  "model": "wan2.7-reference-video",
  "prompt": "Image 1 and Image 2 are having a conversation in a modern office. Image 1 explains the product while Image 2 takes notes. The scene is professional and well-lit.",
  "image_urls": [
    "https://your-cdn.com/spokesperson-a.jpg",
    "https://your-cdn.com/spokesperson-b.jpg"
  ],
  "image_start": "https://your-cdn.com/office-wide-shot.jpg",
  "model_params": {
    "voice_bindings": {
      "image1": "https://your-cdn.com/voice-a.mp3",
      "image2": "https://your-cdn.com/voice-b.mp3"
    }
  },
  "quality": "1080p",
  "duration": 10
}

Multi-Grid-Storyboard

Für Einzelbild-Referenzen mit mehreren Panels (z.B. ein 3×3-Raster mit Charakterposen):

{
  "model": "wan2.7-reference-video",
  "prompt": "Reference image. 3D cartoon style. 1. Wide shot of fantasy forest. 2. Boy parts the vines. 3. Robot scans ahead. 4. Close-up of map. 5. Boy's excited face. 6. They leap over roots.",
  "image_urls": ["https://your-cdn.com/storyboard-grid.png"],
  "duration": 15
}

6. Modus 4: Videobearbeitung

Funktionsweise

Wichtige Parameter

Beispiel: Rein instruktionsbasierter Stilwechsel

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video-edit",
    "prompt": "Convert the entire scene to a vintage film look with warm color grading and film grain",
    "video_urls": ["https://your-cdn.com/source-clip.mp4"],
    "keep_original_sound": true,
    "duration": 0
  }'

Beispiel: Referenzgesteuerter Kleidungstausch

{
  "model": "wan2.7-video-edit",
  "prompt": "Replace the girl's outfit with the clothes from the reference image",
  "video_urls": ["https://your-cdn.com/source.mp4"],
  "image_urls": ["https://your-cdn.com/target-outfit.png"]
}

Was Sie bearbeiten können

• Stiltransfer: "In Anime-Stil umwandeln", "Aquarellmalerei-Effekt anwenden"
• Hintergrundtausch: "Hintergrund zu einer regennassen Tokioter Straße bei Nacht ändern"
• Objekt-/Kleidungswechsel: "Jacke auf Rot ändern", "Hut durch Krone ersetzen"
• Kolorierung: "Dieses Schwarz-Weiß-Material in Farbe umwandeln"
• Beleuchtung: "Beleuchtung auf Goldene Stunde umstellen"

7. Preise und Kostenberechnung

EvoLink Wan 2.7-Preise

Keine Abonnements, keine Mindestabnahmen. Sie bezahlen nur für erfolgreich generiertes Video.

Kostenvergleich mit anderen Anbietern (gemäß Anbieterseiten, Mai 2026)

Spezielle Abrechnung für Reference-Video und Video-Edit

Formel zur Budgetschätzung

8. Asynchroner Workflow und Task-Management

Jede Wan 2.7-Anfrage folgt dem gleichen asynchronen Muster:

Task-Lebenszyklus

Callback-URL (Webhook)

Best Practices für die Produktion

1. Speichern Sie die Task-ID sofort nach der Übermittlung. Bei einem Serviceausfall können Sie die Daten wiederherstellen.
2. Verwenden Sie exponentielles Backoff beim Abfragen. Beginnen Sie bei 5 Sekunden, Obergrenze bei 30 Sekunden.
3. Laden Sie Ergebnisse sofort herunter und archivieren Sie sie. Video-URLs laufen nach 24 Stunden ab.
4. Machen Sie Übermittlungen idempotent. Hashen Sie Anfrage-Payloads und deduplizieren Sie, um Doppelabrechnung durch Wiederholungsstürme zu vermeiden.

9. Fehlerbehandlung und häufige Statuscodes

Häufige Fehler

• Falsche Schreibweise der Modell-ID. Es heißt wan2.7-text-to-video, nicht wan-2.7-text-to-video oder wan27-t2v. Eine veraltete Modell-ID gibt einen 404 ohne hilfreiche Fehlermeldung zurück.
• Ungültige Medienkombinationen im I2V-Modus senden. Prüfen Sie die Tabelle gültiger Eingabekombinationen.
• Ergebnisse nicht rechtzeitig herunterladen. Video-URLs laufen nach 24 Stunden ab. Bauen Sie automatisches Herunterladen in Ihre Pipeline ein.

10. Produktionsmuster und Sicherheitsvorkehrungen

Budget-Leitplanken

Zuverlässigkeitsmuster

• Wiederholung mit Idempotenzschlüssel. Hashen Sie Ihren Anfrage-Payload und prüfen Sie auf bestehende Tasks vor dem erneuten Senden.
• Timeout-Behandlung. Wenn ein Task nach 5 Minuten nicht abgeschlossen ist, markieren Sie ihn zur manuellen Überprüfung, statt blind erneut zu senden.
• Fallback-Strategie. Erwägen Sie einen Fallback auf Wan 2.6 oder Wan 2.5, wenn Wan 2.7 bei einem bestimmten Modus anhaltende Fehler liefert.
• Asset-Validierung. Validieren Sie Bildabmessungen, Videodauer und Audioformat vor der Übermittlung. Fehlerhafte Assets verursachen Fehler, die wie Modellqualitätsprobleme aussehen.

Warteschlangenarchitektur

Für Produktionssysteme, die mehr als 100 Videos/Tag generieren:

Rufen Sie die API niemals direkt aus benutzerseitigen Request-Handlern auf. Gehen Sie immer über ein Hintergrund-Job-System.

11. Migration von Wan 2.6 auf Wan 2.7

Was gleich bleibt

• API-Endpunkt: POST /v1/videos/generations
• Authentifizierung: gleicher API-Key und Bearer-Token
• Asynchrones Muster: gleiche Task-ID / Polling / Callback-Ablauf
• EvoLink-Abrechnung: gleiches Konto und Kreditsystem

Was sich ändert

Schritt-für-Schritt-Migration

1. Modellparameter ändern. Ersetzen Sie wan2.6-text-to-video durch wan2.7-text-to-video (ebenso für andere Modi).
2. Mit bestehenden Prompts testen. Wan 2.7 verarbeitet das gleiche Promptformat. Kein Umschreiben nötig.
3. Neue Features schrittweise einführen. Fügen Sie generation_mode, image_end, voice_bindings oder Video-Edit hinzu, wenn Ihr Workflow es erfordert.
4. Wan 2.6 als Fallback behalten. Beide Versionen laufen parallel auf EvoLink. Sie müssen nicht alles auf einmal migrieren.

12. Parameter-Referenz-Spickzettel

Gemeinsame Parameter (alle Modi)

Text-to-Video-spezifisch

Image-to-Video-spezifisch

Reference-Video-spezifisch

Video-Edit-spezifisch

13. FAQ

Was kostet Wan 2.7 auf EvoLink?

$0.086/Sek. bei 720p, $0.144/Sek. bei 1080p. Ein 10-Sekunden-720p-Clip kostet $0.86. Keine Abonnements oder Mindestabnahmen.

Was ist der Unterschied zwischen Wan 2.7 und Wan 2.6?

Auf EvoLink bietet Wan 2.7 Videobearbeitung, Multi-Charakter-Referenzvideo mit Voice Cloning und First-and-Last-Frame-Steuerung im I2V-Modus. Wan 2.6 bleibt nützlich für cinematisches Storytelling und Flash-Varianten für schnellere Iteration. Beide laufen parallel auf EvoLink.

Generiert Wan 2.7 automatisch Audio?

Werden fehlgeschlagene Tasks berechnet?

Für Reference-Video- und Video-Edit-Modi werden fehlgeschlagene Tasks ausdrücklich nicht berechnet. Für Text-to-Video und Image-to-Video basiert die Abrechnung auf der tatsächlich generierten Videodauer.

Kann ich Wan 2.7 für NSFW-Inhalte verwenden?

Welche Audioformate werden für Voice Cloning unterstützt?

Wie gehe ich mit dem Ablauf von Video-URLs um?

Video-URLs laufen nach 24 Stunden ab. Bauen Sie einen automatischen Download-und-Archivierungsschritt in Ihre Pipeline ein, direkt nach Task-Abschluss. Speichern Sie das finale Asset in Ihrem eigenen CDN oder Objektspeicher.

Kann ich von Wan 2.6 ohne Ausfallzeit migrieren?

Nächste Schritte

• Playground ausprobieren: Wan 2.7 Modellseite
• Wan-Modelle vergleichen: Wan API-Familiensammlung
• Vollständige Preisaufschlüsselung: Wan API-Preisleitfaden
• Wan 2.6 Produktionsmuster: Wan 2.6 API-Leitfaden
• Wan 2.5 Review: Wan 2.5 API-Review