PopNowAPI
API-Schlüssel holen

Wan 3.0 Plus API

von Alibaba

Wan 3.0 Bild zu Video, bis 30 Sekunden mit Ton

alibaba/wan-3.0-plus/image-to-video
  • Bis 1080p
  • Clips mit 2–30 s
  • Mit Ton
  • Start- und Endbild
  • 5 Seitenverhältnisse
  • Bild zu Video
  • Video verlängern

Du rufst es mit dem Modellnamen alibaba/wan-3.0-plus/image-to-video über POST /jobs/createTask auf, ab 0,285 $.

Modellnamealibaba/wan-3.0-plus/image-to-video
EndpunktPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-3.0-plus/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Der input ist aus dem Schema unten gebaut und besteht die Prüfung so, wie er dasteht. Ersetz Prompt und Links durch deine eigenen.

Preis

OptionUSD pro Sekunde
resolution 480p0,057 $
resolution 720p0,114 $
resolution 1080p0,228 $

Abrechnung in USD · Alle Optionen und Preise: GET /models/alibaba/wan-3.0-plus/image-to-video

Limits

Cliplänge
2–30 s
Auflösungen
480p · 720p · 1080p
Seitenverhältnisse
16:9 · 9:16 · 1:1 · 4:3 · 3:4

Parameter

Diese Felder stammen aus demselben Schema, gegen das wir jede Anfrage prüfen. Nicht aufgeführte Felder werden abgelehnt.

Manche Felder hängen voneinander ab (zum Beispiel mindestens eine Referenz). Die genauen Regeln stehen im rohen Schema ganz unten.

  • image_urlstringPflicht

    Das Bild, von dem aus es losgeht.

    Bereich
    image/jpeg, image/png, image/webp, image/gif
  • promptstringOptional

    Describe the subject, action, camera, light, pacing, and sound for the shot.

    Bereich
    1 – … chars
  • last_image_urlstringOptional

    Optionales Endbild, damit der Clip genau dort endet, wo du willst.

    Bereich
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringOptional

    Die Form des Bildes: breit, quadratisch oder hoch.

    Erlaubte Werte
    "16:9""9:16""1:1""4:3""3:4"
  • resolutionstringOptionalÄndert den Preis

    Ausgabegröße. Größere Formate sind schärfer und kosten mehr.

    Standardwert
    "720p"
    Erlaubte Werte
    "480p""720p""1080p"
  • duration_secondsintegerOptionalÄndert den Preis

    Wie lang der Clip läuft. Abgerechnet wird pro Sekunde.

    Standardwert
    5
    Erlaubte Werte
    23456789101112131415161718192021222324252627282930
  • generate_audiobooleanOptional

    Fügt passenden Ton hinzu: Stimmen, Atmo und Effekte.

    Standardwert
    true
  • enable_prompt_expansionbooleanOptional

    Lässt das Modell einen kurzen Prompt mit Details ergänzen.

    Standardwert
    false
  • seedintegerOptional

    Dieselbe Zahl liefert ein wiederholbares Ergebnis.

    Bereich
    0 – 2147483647
Rohes JSON-Schema
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "required": [
          "last_image_url"
        ]
      },
      "then": {
        "required": [
          "image_url"
        ]
      }
    }
  ],
  "properties": {
    "aspect_ratio": {
      "description": "Output aspect ratio. Omit it to let the clip adapt to the opening image; a ratio that differs from the image crops it.",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Requested output length in whole seconds.",
      "enum": [
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25,
        26,
        27,
        28,
        29,
        30
      ],
      "type": "integer"
    },
    "enable_prompt_expansion": {
      "default": false,
      "description": "Allow the service to expand the submitted creative brief before generation.",
      "type": "boolean"
    },
    "generate_audio": {
      "default": true,
      "description": "Request generated audio with the video.",
      "type": "boolean"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Opening-frame image.",
      "type": "string"
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional last frame: the clip ends on this image. Requires image_url.",
      "type": "string"
    },
    "prompt": {
      "description": "Describe the subject, action, camera, light, pacing, and sound for the shot.",
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution.",
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object"
}

Antworten, Polling und Callbacks

Alle Modelle funktionieren gleich: Task anlegen, dann pollen oder auf den Callback warten.

Erst den Preis prüfen

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/wan-3.0-plus/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

Sende vor dem Start denselben Anfrage-Body an POST /jobs/quote, um die geschätzten und maximalen Kosten in USD zu sehen. Die Preisabfrage führt keine Aufgabe aus und belastet dein Guthaben nicht.

Angenommen

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 bedeutet angenommen: Der USD-Höchstbetrag bleibt bis zur Abrechnung reserviert. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.

Status abfragen

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Frag alle paar Sekunden mit wachsendem Abstand ab und hör auf, sobald state succeeded, failed, canceled oder expired ist.

Fertiger Task

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "alibaba/wan-3.0-plus/image-to-video",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.mp4?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "video/mp4",
          "width": 1280,
          "height": 720,
          "durationSeconds": 5
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Lad über die url vor expiresAt herunter. Später einen frischen Link nötig? Frag POST /common/download-url.

Callback prüfen

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Mit gesetzter callBackUrl schicken wir dir den fertigen Task. Prüf die Signatur am rohen Body, bevor du ihm vertraust.

Lokale Datei schicken

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Öffentliche https-Links funktionieren direkt. Lokale Dateien laufen vorher über upload-url und commit.

Über Wan 3.0 Plus

Wan 3.0 Bild zu Video, bis 30 Sekunden mit Ton.

Du rufst es mit dem Modellnamen alibaba/wan-3.0-plus/image-to-video über POST /jobs/createTask auf, ab 0,285 $.

Anfrageparameter

ParameterPflichtBeschreibung
aspect_ratioNeinDie Form des Bildes: breit, quadratisch oder hoch. 16:9 · 9:16 · 1:1 · 4:3 · 3:4
duration_secondsNeinWie lang der Clip läuft. Abgerechnet wird pro Sekunde. 2–30 · Standardwert: 5
enable_prompt_expansionNeinLässt das Modell einen kurzen Prompt mit Details ergänzen. Standardwert: false
generate_audioNeinFügt passenden Ton hinzu: Stimmen, Atmo und Effekte. Standardwert: true
image_urlJaDas Bild, von dem aus es losgeht.
last_image_urlNeinOptionales Endbild, damit der Clip genau dort endet, wo du willst.
promptNeinDescribe the subject, action, camera, light, pacing, and sound for the shot.
resolutionNeinAusgabegröße. Größere Formate sind schärfer und kosten mehr. 480p · 720p · 1080p · Standardwert: 720p
seedNeinDieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647

Preise

Die Preise sind in USD angegeben. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.

OptionUSD pro Sekunde
resolution 480p0,057 $
resolution 720p0,114 $
resolution 1080p0,228 $

Sende vor dem Start denselben Anfrage-Body an POST /jobs/quote, um die geschätzten und maximalen Kosten in USD zu sehen. Die Preisabfrage führt keine Aufgabe aus und belastet dein Guthaben nicht.

API-Schnellstart

Die Wan 3.0 Plus API in drei Schritten aufrufen

  1. API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow-. API-Aufrufe nutzen dein separates Guthaben in US-Dollar.
  2. Anfrage senden. Sende POST /jobs/createTask mit model alibaba/wan-3.0-plus/image-to-video und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
  3. Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-3.0-plus/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.

Fragen zur Wan 3.0 Plus API

Was kostet die Wan 3.0 Plus API?

Wan 3.0 Plus gibt es ab 0,285 $ für einen 5-Sekunden-Clip – mit Bild zu Video, der günstigsten Aufgabe. Preise nach Option: 480p 0,057 $ pro Sekunde, 720p 0,114 $ pro Sekunde, 1080p 0,228 $ pro Sekunde. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.

Wie lautet der Modellname von Wan 3.0 Plus in der API?

Trag alibaba/wan-3.0-plus/image-to-video für Bild zu Video; alibaba/wan-3.0-plus/video-extend für Video verlängern im Feld model von POST /jobs/createTask ein.

Welche Limits hat die Wan 3.0 Plus API?

Cliplänge: 2–30 s; Auflösungen: 480p · 720p · 1080p; Seitenverhältnisse: 16:9 · 9:16 · 1:1 · 4:3 · 3:4. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.

Mehr zu Wan 3.0 Plus