Anleitung: Bilder in Videos verwandeln

Video dauert Minuten statt Sekunden. Eine Video-Integration baut deshalb auf Tasks und Webhooks, nicht auf eine einzelne wartende Anfrage. Diese Anleitung zeigt die üblichen Aufgaben mit echten Modell-IDs.

Ein Bild animieren

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "alibaba/wan-3.0/image-to-video",
    "input": {
      "image_url": "https://media.popnow.ai/movie/lighthouse.webp",
      "prompt": "Waves roll in slowly, clouds drift, the camera pushes gently toward the lighthouse",
      "resolution": "480p",
      "duration_seconds": 5
    },
    "callBackUrl": "https://your-app.example.com/hooks/popnow"
  }'

Du bekommst sofort ein 202 mit einer taskId. Ein paar Minuten später liefert der Webhook den fertigen Task, oder du liest ihn mit recordInfo. Das Video steckt in output.assets[0], mit durationSeconds, width und height.

Was es kostet

Die meisten Videomodelle rechnen pro Sekunde Ausgabe ab, und der Satz steigt mit der Auflösung. Bei alibaba/wan-3.0/image-to-video sind das 6,75 Credits pro Sekunde bei 480p, 13,5 bei 720p und 27 bei 1080p – die Anfrage oben reserviert also 34 Credits (5 × 6,75, aufgerundet) und kostet bei Erfolg genauso viel.

• Fang beim Feilen an Prompts mit der niedrigsten Auflösung und kurzer Dauer an und erhöh beides erst für den finalen Render.
• Frag jobs/quote nach dem genauen Preis, bevor du ihn Nutzern zeigst.
• Ein gescheitertes oder abgelaufenes Video kostet nichts.

Erstes und letztes Bild festlegen

Viele Bild-zu-Video-Modelle nehmen zusätzlich last_image_url. Der Clip beginnt mit image_url und endet genau auf last_image_url – so entstehen Verwandlungen oder ein nahtloser Loop (nimm für beides dasselbe Bild).

Referenzvideo: Figur oder Produkt konsistent halten

reference-to-video-Modelle bauen eine neue Szene um ein oder mehrere Referenzbilder (bei manchen Modellen auch Referenzvideo oder -audio), statt ein vorgegebenes erstes Bild zu animieren:

{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "The same lighthouse at night, its beam sweeping over a calm sea while the camera circles slowly",
    "reference_image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"],
    "duration_seconds": 6
  }
}

Wie ein Modell seine Referenzen im Prompt anspricht, ist unterschiedlich; die Feldbeschreibungen auf seiner Referenzseite sagen es dir.

Einen Clip verlängern

video-extend-Modelle setzen einen vorhandenen Clip ab seinem letzten Bild fort. Schick den Clip als video_url und beschreib, was als Nächstes passiert:

{
  "model": "minimax/h3/video-extend",
  "input": {
    "video_url": "https://media.popnow.ai/showcase/moon-picnic-loop.mp4",
    "prompt": "The camera keeps drifting right as the picnic blanket ripples in the breeze"
  }
}

Verlängerungsmodelle, die die Clips zusammenfügen, liefern zwei Assets: zuerst das zusammengesetzte Video (role: "video"), dann den neuen Teil allein (role: "segment").

Ton

Modelle mit generate_audio geben dem Clip einen Soundtrack; ausgeschaltet kann es bei manchen Modellen günstiger sein. Um ein vorhandenes Video zu vertonen, nimm popnow/foley-v1/video-to-audio – es liefert dasselbe Video mit generiertem Ton zurück.

Prompts, die bei Video funktionieren

Beschreib Bewegung, nicht nur die Szene: was sich bewegt, wie schnell und was die Kamera tut. „Die Kamera fährt langsam heran, während sich die Person zum Licht dreht“ gibt dem Modell etwas zu tun; „ein schöner Leuchtturm“ nicht. Wie die Dinge aussehen, zeigt schon das Bild – nutz die Worte für das, was sich verändert.

Ein Muster für die Produktion

1. Lade das Ausgangsbild hoch oder speichere es und merk dir seine popnow://-URI.
2. Hol ein Angebot, zeig den Preis und ruf dann createTask mit einem Idempotency-Key aus deiner eigenen Job-ID und einer callBackUrl auf.
3. Prüf im Webhook die Signatur, bestätige zuerst und lade das Video dann in deinen eigenen Speicher.
4. Liste einmal am Tag die letzten Tasks mit GET /api/v1/jobs und lies die, deren Webhook nie ankam.

Den Rest findest du in der Checkliste für den Livegang.