API · API Wan 3.0 Pro Prime Da riferimenti a video

alibaba/wan-3.0-pro-prime/reference-to-videoDa 176 crediti per una clip di 5 secondi· Da riferimenti a video

Il reference-to-video Wan 3.0 Pro Prime fissa volto, capo, set, movimento o voce con fino a 10 riferimenti immagine, 5 video e 5 audio. Rende 2–30 secondi a 1080p, 2K o 4K, ingranditi da 1080p oltre tale livello.

Lo chiami con il nome di modello alibaba/wan-3.0-pro-prime/reference-to-video su POST /jobs/createTask, da 176 crediti per una clip di 5 secondi (1,76 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.

Crea video
Da immagine a video
Da riferimenti a video
Allunga video
Fino a 4K
Clip da 2 a 30 s
Audio incluso
Fotogramma iniziale e finale
Fino a 10 immagini di riferimento
5 formati

di AlibabaOttieni una chiave API Esempi e prompt di Wan 3.0 Pro Prime →

Nome del modelloalibaba/wan-3.0-pro-prime/reference-to-video

EndpointPOST 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"])

L’input è costruito dallo schema qui sotto, quindi supera la verifica così com’è. Sostituisci prompt e link con i tuoi.

Prezzo

Opzione	Crediti al secondo	≈ USD
`resolution 1080p`	35,1	0,35 USD
`resolution 2K`	37,8	0,38 USD
`resolution 4K`	41,85	0,42 USD

1 credito = 0,01 $ · Tutte le opzioni e i prezzi: GET /models/alibaba/wan-3.0-pro-prime/reference-to-video

Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 176 crediti per una clip di 5 secondi (1,76 USD).

Limiti

Durata della clip: 2–30 s
Risoluzioni: 1080p · 2K · 4K
Proporzioni: 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
Audio di riferimento: 5
Immagini di riferimento: 10
Video di riferimento: 5
Lunghezza del prompt (caratteri): 20,000

Parametri

Questi campi vengono dallo stesso schema con cui verifichiamo ogni richiesta. I campi non elencati vengono rifiutati.

Alcuni campi dipendono l’uno dall’altro (per esempio, almeno un riferimento). Lo schema grezzo in fondo riporta le regole esatte.

promptstringFacoltativo
Describe the subject, motion and camera.
Intervallo
1 – 20000 chars
reference_image_urlsarray<string>A volte obbligatorio
Immagini di persone, abiti o luoghi che il risultato deve mantenere.
Intervallo
1 – 10 items · image/jpeg, image/png, image/webp, image/gif
reference_video_urlsarray<string>A volte obbligatorioCambia il prezzo
Clip di cui seguire il movimento, la camera o lo stile.
Intervallo
1 – 5 items · video/mp4, video/webm, video/quicktime
reference_audio_urlsarray<string>A volte obbligatorio
Audio da riprendere: una voce, una musica o un ritmo.
Intervallo
1 – 5 items · audio/mpeg, audio/wav
reference_file_urlstringA volte obbligatorio
One reference document (PDF, DOCX, TXT, MD and similar) that the model reads for characters, wardrobe, setting and action.
Intervallo
application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.ms-excel +8
reference_link_urlstringA volte obbligatorio
One public web page the model reads for reference. It must open without a login.
resolutionstringFacoltativoCambia il prezzo
Dimensione dell'output. Più grande è più nitido e costa di più.
Predefinito
"1080p"
Valori ammessi
"1080p""2k""4k"
aspect_ratiostringFacoltativo
La forma dell'inquadratura: larga, quadrata o verticale.
Predefinito
"adaptive"
Valori ammessi
"16:9""4:3""1:1""3:4""9:16""adaptive"
duration_secondsintegerFacoltativoCambia il prezzo
Quanto dura la clip. Si paga al secondo.
Predefinito
5
Valori ammessi
-123456789101112131415161718192021222324252627282930
generate_audiobooleanFacoltativo
Aggiunge un audio adatto all'immagine: voci, ambiente ed effetti.
Predefinito
true
enable_prompt_expansionbooleanFacoltativo
Lascia che il modello arricchisca un prompt breve.
Predefinito
true
seedintegerFacoltativo
Lo stesso numero dà un risultato ripetibile.
Intervallo
0 – 2147483647

JSON Schema grezzo

{
  "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"
}

Un risultato reale di 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.

La stessa richiesta tramite 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
  }
}

Questo risultato parte da un file caricato: metti il tuo link al posto di quello d’esempio.

Risposte, polling e callback

Tutti i modelli funzionano allo stesso modo: crei un task, poi lo interroghi o aspetti la callback.

Prima il prezzo

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
  }
}'

Stesso corpo di createTask. Restituisce l’addebito previsto e quello massimo possibile, senza eseguire nulla.

Accettata

HTTP

HTTP/1.1 202 Accepted

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

HTTP 202 significa che il task è stato accettato e i crediti sono riservati, non ancora addebitati. L’addebito finale non supera mai la riserva.

Controlla lo stato

cURL

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

Controlla ogni pochi secondi allungando via via l’intervallo e fermati quando state è succeeded, failed, canceled o expired.

Task completato

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"
}

Scarica dall’url prima di expiresAt. Ti serve un link nuovo più tardi? Chiedilo con POST /common/download-url.

Verifica una callback

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
});

Con callBackUrl impostata ti inviamo il task completato. Verifica la firma sul corpo grezzo prima di fidarti.

Invia un file locale

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.

I link https pubblici funzionano così come sono. I file locali passano prima da upload-url e commit.