API · Wan 3.0 Pro Prime Referenz zu Video API: 4K-Video mit Ton

alibaba/wan-3.0-pro-prime/reference-to-videoAb 176 Credits für einen 5-Sekunden-Clip· Referenz zu Video

Wan 3.0 Pro Prime Referenz-zu-Video fixiert Gesicht, Kleidung, Set, Bewegung oder Stimme mit bis zu 10 Bild-, 5 Video- und 5 Audioreferenzen. Es rendert 2 bis 30 Sekunden in 1080p, 2K oder 4K, darüber aus 1080p hochgerechnet.

Du rufst es mit dem Modellnamen alibaba/wan-3.0-pro-prime/reference-to-video über POST /jobs/createTask auf, ab 176 Credits für einen 5-Sekunden-Clip (1,76 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

Video erstellen
Bild zu Video
Referenz zu Video
Video verlängern
Bis 4K
Clips mit 2–30 s
Mit Ton
Start- und Endbild
Bis zu 10 Referenzbilder
5 Seitenverhältnisse

von AlibabaAPI-Schlüssel holen Wan 3.0 Pro Prime: Beispiele und Prompts →

Modellnamealibaba/wan-3.0-pro-prime/reference-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-pro-prime/reference-to-video",
  "input": {
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "resolution": "1080p",
    "aspect_ratio": "adaptive",
    "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"

// Node 18+ (or any runtime with fetch). Keep the API key on your server.
const BASE = "https://api.popnow.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function call(path, init = {}) {
  const res = await fetch(BASE + path, { ...init, headers: { ...headers, ...init.headers } });
  const body = await res.json();
  if (body.code !== 200) throw new Error(`${body.code} ${body.msg}`);
  return body.data;
}

const { taskId } = await call("/jobs/createTask", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    "model": "alibaba/wan-3.0-pro-prime/reference-to-video",
    "input": {
      "reference_image_urls": [
        "https://media.popnow.ai/influencer/examples/ava.webp"
      ],
      "resolution": "1080p",
      "aspect_ratio": "adaptive",
      "duration_seconds": 5
    }
  }),
});

// Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
let task;
for (let delay = 2000; ; delay = Math.min(delay * 1.5, 15000)) {
  await sleep(delay);
  task = await call(`/jobs/recordInfo?taskId=${taskId}`);
  const copying = (task.output?.assets ?? []).some((a) => a.pending && !a.unavailable);
  if (["succeeded", "failed", "canceled", "expired"].includes(task.state) && !copying) break;
}
if (task.state !== "succeeded") throw new Error(`${task.state}: ${task.errorMessage ?? "no detail"}`);

// Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for (const asset of task.output.assets) console.log(asset.url);

import os, time, uuid, requests

BASE = "https://api.popnow.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}


def call(method, path, **kwargs):
    body = requests.request(method, BASE + path, headers={**HEADERS, **kwargs.pop("headers", {})}, timeout=30, **kwargs).json()
    if body["code"] != 200:
        raise RuntimeError(f'{body["code"]} {body["msg"]}')
    return body["data"]


task_id = call(
    "POST",
    "/jobs/createTask",
    headers={"Idempotency-Key": str(uuid.uuid4())},  # reuse it if you retry
    json={
        "model": "alibaba/wan-3.0-pro-prime/reference-to-video",
        "input": {
            "reference_image_urls": [
                "https://media.popnow.ai/influencer/examples/ava.webp"
            ],
            "resolution": "1080p",
            "aspect_ratio": "adaptive",
            "duration_seconds": 5
        }
    },
)["taskId"]

# Poll with backoff. A finished task may still be copying files: wait while an asset is pending.
delay = 2.0
while True:
    time.sleep(delay)
    task = call("GET", "/jobs/recordInfo", params={"taskId": task_id})
    assets = (task.get("output") or {}).get("assets") or []
    copying = any(a.get("pending") and not a.get("unavailable") for a in assets)
    if task["state"] in ("succeeded", "failed", "canceled", "expired") and not copying:
        break
    delay = min(delay * 1.5, 15.0)

if task["state"] != "succeeded":
    raise RuntimeError(f'{task["state"]}: {task.get("errorMessage", "no detail")}')

# Each asset has a signed url (no API key needed) that expires at expiresAt: save the file.
for asset in assets:
    print(asset["url"])

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

Option	Credits pro Sekunde	≈ USD
`resolution 1080p`	35,1	0,35 $
`resolution 2K`	37,8	0,38 $
`resolution 4K`	41,85	0,42 $

1 Credit = 0,01 $ · Alle Optionen und Preise: GET /models/alibaba/wan-3.0-pro-prime/reference-to-video

Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 176 Credits für einen 5-Sekunden-Clip (1,76 $).

Limits

Cliplänge: 2–30 s
Auflösungen: 1080p · 2K · 4K
Seitenverhältnisse: 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
Referenz-Audio: 5
Referenzbilder: 10
Referenzvideos: 5
Prompt-Länge (Zeichen): 20,000

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.

promptstringOptional
Describe the subject, motion and camera.
Bereich
1 – 20000 chars
reference_image_urlsarray<string>Manchmal Pflicht
Bilder von Personen, Outfits oder Orten, die das Ergebnis beibehalten soll.
Bereich
1 – 10 items · image/jpeg, image/png, image/webp, image/gif
reference_video_urlsarray<string>Manchmal PflichtÄndert den Preis
Clips, deren Bewegung, Kamera oder Stil übernommen werden soll.
Bereich
1 – 5 items · video/mp4, video/webm, video/quicktime
reference_audio_urlsarray<string>Manchmal Pflicht
Ton zum Angleichen: eine Stimme, Musik oder ein Rhythmus.
Bereich
1 – 5 items · audio/mpeg, audio/wav
reference_file_urlstringManchmal Pflicht
One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.
Bereich
application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.ms-excel +8
reference_link_urlstringManchmal Pflicht
One public web page the model reads for reference. It must open without a login.
resolutionstringOptionalÄndert den Preis
Ausgabegröße. Größere Formate sind schärfer und kosten mehr.
Standardwert
"1080p"
Erlaubte Werte
"1080p""2k""4k"
aspect_ratiostringOptional
Die Form des Bildes: breit, quadratisch oder hoch.
Standardwert
"adaptive"
Erlaubte Werte
"16:9""4:3""1:1""3:4""9:16""adaptive"
duration_secondsintegerOptionalÄndert den Preis
Wie lang der Clip läuft. Abgerechnet wird pro Sekunde.
Standardwert
5
Erlaubte Werte
-123456789101112131415161718192021222324252627282930
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
true
seedintegerOptional
Dieselbe Zahl liefert ein wiederholbares Ergebnis.
Bereich
0 – 2147483647

Rohes JSON-Schema

{
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "reference_image_urls"
      ]
    },
    {
      "required": [
        "reference_video_urls"
      ]
    },
    {
      "required": [
        "reference_audio_urls"
      ]
    },
    {
      "required": [
        "reference_file_url"
      ]
    },
    {
      "required": [
        "reference_link_url"
      ]
    }
  ],
  "properties": {
    "aspect_ratio": {
      "default": "adaptive",
      "description": "Output aspect ratio; adaptive follows the input media and the intent.",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16",
        "adaptive"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Output duration in seconds. Pass -1 for smart duration: the model picks the length from the prompt and any input media instead of a fixed number. With reference videos, their total length plus the output length must not exceed 30 seconds, and the reference video seconds are billed together with the output seconds.",
      "enum": [
        -1,
        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": true,
      "description": "Expand the prompt before generation.",
      "type": "boolean"
    },
    "generate_audio": {
      "default": true,
      "description": "Include an audio track in the output.",
      "type": "boolean"
    },
    "prompt": {
      "description": "Describe the subject, motion and camera.",
      "maxLength": 20000,
      "minLength": 1,
      "type": "string"
    },
    "reference_audio_urls": {
      "description": "Reference audio, up to 5 clips of 1 to 15 seconds each and 15 seconds in total.",
      "items": {
        "contentMediaType": [
          "audio/mpeg",
          "audio/wav"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 1,
      "type": "array"
    },
    "reference_file_url": {
      "contentMediaType": [
        "application/pdf",
        "application/msword",
        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
        "application/vnd.ms-excel",
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "application/vnd.ms-powerpoint",
        "application/vnd.openxmlformats-officedocument.presentationml.presentation",
        "application/vnd.apple.keynote",
        "application/vnd.apple.pages",
        "application/vnd.apple.numbers",
        "text/plain",
        "text/markdown"
      ],
      "description": "One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.",
      "format": "uri",
      "type": "string"
    },
    "reference_image_urls": {
      "description": "Ordered reference images used to guide the scene.",
      "items": {
        "contentMediaType": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/gif"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "reference_link_url": {
      "description": "One public web page the model reads for reference. It must open without a login.",
      "format": "uri",
      "type": "string"
    },
    "reference_video_urls": {
      "description": "Reference videos, up to 5 clips of 1 to 15 seconds each and 15 seconds in total.",
      "items": {
        "contentMediaType": [
          "video/mp4",
          "video/webm",
          "video/quicktime"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 1,
      "type": "array"
    },
    "resolution": {
      "default": "1080p",
      "description": "Output resolution tier. A native Wan 3.0 Prime render tops out at 1080p; 2k and 4k are enlarged from that render, not rendered natively.",
      "enum": [
        "1080p",
        "2k",
        "4k"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed. Omit for a generated seed.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

Ein echtes Ergebnis von Wan 3.0 Pro Prime

PromptImage 1 is the woman, Image 2 is the man — keep both faces and both haircuts. They stand on either side of a workbench in a dim garage; she looks up from what she is doing and he leans in to see it. Slow push-in, one hanging bulb, room tone only.

Dieselbe Anfrage über die API

{
  "model": "alibaba/wan-3.0-pro-prime/reference-to-video",
  "input": {
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "Image 1 is the woman, Image 2 is the man — keep both faces and both haircuts. They stand on either side of a workbench in a dim garage; she looks up from what she is doing and he leans in to see it. Slow push-in, one hanging bulb, room tone only.",
    "seed": 220913
  }
}

Dieses Ergebnis startete mit einer hochgeladenen Datei: Setz deinen eigenen Link dort ein, wo der Beispiel-Link steht.

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-pro-prime/reference-to-video",
  "input": {
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "resolution": "1080p",
    "aspect_ratio": "adaptive",
    "duration_seconds": 5
  }
}'

Gleicher Body wie bei createTask. Liefert die erwartete und die höchstmögliche Abbuchung und startet nichts.

Angenommen

HTTP

HTTP/1.1 202 Accepted

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

HTTP 202 heißt: Der Task ist angenommen, die Credits sind reserviert, aber noch nicht abgebucht. Die endgültige Abbuchung liegt nie über der Reservierung.

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-pro-prime/reference-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.