Wan 3.0 API

Vollständige API-Referenz für die Videogenerierungsmodelle Wan 3.0 von Alibaba.

Modellvarianten

Diese API unterstützt vier Modellvarianten:

Schnellvergleich

Gemeinsamer Endpunkt

Alle Wan 3.0-Varianten verwenden den Endpunkt für Videoaufgaben:

POST /api/v1/video/task

Gemeinsame Parameter

Erforderlich

Optional

Wan 3.0 Text zu Video

Setzen Sie model_name auf "wan-3.0-text-to-video" und geben Sie die gemeinsam erforderlichen Parameter an.

Beispielanfrage

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'wan-3.0-text-to-video',
    prompt: 'A cinematic tracking shot follows a cyclist through a rain-soaked neon city at night',
    duration: 8,
    resolution: '1080p',
    aspect_ratio: '16:9',
    sound: true,
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Wan 3.0 Bild zu Video

Erforderliche Bildeingaben

Beide Bilder müssen JPEG, JPG, PNG ohne Alphakanal, BMP oder WEBP verwenden. Jede Bildseite muss zwischen 240 und 8000 Pixel groß sein.

Beispielanfrage

javascriptKopieren
{
  model_name: 'wan-3.0-image-to-video',
  prompt: 'The camera glides forward as daylight gradually shifts into a warm evening glow',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Videobearbeitung

Erforderliche Videoeingabe

Die Dauer des Quellvideos plus die angeforderte Ausgabe-duration darf 30 Sekunden nicht überschreiten.

Beispielanfrage

javascriptKopieren
{
  model_name: 'wan-3.0-video-edit',
  prompt: 'Turn the daytime scene into a rainy evening while preserving the subject and camera movement',
  video_url: 'https://example.com/source-video.mp4',
  duration: 10,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 Referenz zu Video

Referenzeingaben sind optional und können kombiniert werden, mit Ausnahme von files und links, die nicht gemeinsam übermittelt werden können.

Optionale Referenzeingaben

Beispielanfrage

javascriptKopieren
{
  model_name: 'wan-3.0-reference-to-video',
  prompt: 'Use the references to create a cinematic product launch with coordinated motion and sound',
  duration: 12,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/product-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/sound-reference.mp3'],
  links: ['https://example.com/public-creative-brief'],
  seed: 42
}

Um eine Referenzdatei anstelle einer Webseite zu verwenden, lassen Sie links weg und übergeben Sie eine einzelne URL in files.

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für die Statusabfrage zurück:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Antwort auf Statusabfrage

Rufen Sie GET /api/v1/video/{taskId} ab, um den Status zu prüfen:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Statuswerte

• submitted: Aufgabe angenommen und wartet auf die Verarbeitung
• processing: Videogenerierung läuft
• succeed: Videogenerierung abgeschlossen
• failed: Videogenerierung fehlgeschlagen

Bewährte Verfahren

1. Ausrichtung der Anweisung: Beschreiben Sie Motive, Aktionen, Kamerabewegung, Tempo, Umgebung und gewünschte Klangwirkung klar.
2. Bildeingaben: Verwenden Sie Start-, End- und Referenzbilder, die dem angeforderten Seitenverhältnis entsprechen. PNG-Bilder dürfen keinen Alphakanal enthalten.
3. Zeitplanung der Videobearbeitung: Prüfen Sie die Quelldauer, bevor Sie die angeforderte Ausgabedauer wählen, damit die Gesamtdauer höchstens 30 Sekunden beträgt.
4. Referenzlimits: Prüfen Sie vor dem Absenden Anzahl, Format, Abmessungen und Gesamtdauer jeder Referenzsammlung.
5. Dateien und Links: Übermitteln Sie entweder eine Referenzdatei oder einen Link zu einer öffentlichen Webseite, niemals beides in derselben Anfrage.