alibaba/wan-2.6/image-to-videoDa 68 crediti per una clip di 5 secondi· Da immagine a videoL’image-to-video Wan 2.6 di Alibaba anima un fotogramma iniziale in esattamente 5, 10 o 15 secondi con audio generato, a 720p o 1080p. Scegli ripresa singola o montaggio multi-inquadratura e aggiungi una traccia audio per guidare i tempi.
Lo chiami con il nome di modello alibaba/wan-2.6/image-to-video su POST /jobs/createTask, da 68 crediti per una clip di 5 secondi (0,68 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.
- Crea video
- Da immagine a video
- Da riferimenti a video
- Fino a 1080p
- Clip da 2 a 15 s
- Fino a 2 immagini di riferimento
- 5 formati
alibaba/wan-2.6/image-to-videoPOST 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-2.6/image-to-video",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5,
"shot_type": "single"
}
}'
# 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-2.6/image-to-video",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5,
"shot_type": "single"
}
}),
});
// 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-2.6/image-to-video",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5,
"shot_type": "single"
}
},
)["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 720p | 13,5 | 0,14 USD |
resolution 1080p | 20,25 | 0,20 USD |
1 credito = 0,01 $ · Tutte le opzioni e i prezzi: GET /models/alibaba/wan-2.6/image-to-video
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 68 crediti per una clip di 5 secondi (0,68 USD).
Limiti
- Durata della clip
- 5–15 s
- Risoluzioni
- 720p · 1080p
- Lunghezza del prompt (caratteri)
- 1,500
Parametri
Questi campi vengono dallo stesso schema con cui verifichiamo ogni richiesta. I campi non elencati vengono rifiutati.
image_urlstringObbligatorioL'immagine di partenza.
promptstringFacoltativoDescribe what happens after the opening frame: the action, the camera, and the mood.
negative_promptstringFacoltativoCiò che non vuoi vedere.
resolutionstringFacoltativoCambia il prezzoDimensione dell'output. Più grande è più nitido e costa di più.
duration_secondsintegerFacoltativoCambia il prezzoQuanto dura la clip. Si paga al secondo.
audio_urlstringFacoltativoLa voce o la musica da usare.
shot_typestringFacoltativoSingle continuous shot, or a multi-shot edit.
enable_prompt_expansionbooleanFacoltativoLascia che il modello arricchisca un prompt breve.
seedintegerFacoltativoLo stesso numero dà un risultato ripetibile.
JSON Schema grezzo
{
"additionalProperties": false,
"properties": {
"audio_url": {
"contentMediaType": [
"audio/mpeg",
"audio/wav"
],
"description": "Audio track that drives lip sync or pacing.",
"type": "string"
},
"duration_seconds": {
"default": 5,
"description": "Requested output length in seconds.",
"enum": [
5,
10,
15
],
"type": "integer"
},
"enable_prompt_expansion": {
"default": false,
"description": "Allow the service to expand the submitted creative brief before generation.",
"type": "boolean"
},
"image_url": {
"contentMediaType": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif"
],
"description": "Opening frame. The clip starts from this image.",
"type": "string"
},
"negative_prompt": {
"description": "List what must not appear in the shot.",
"maxLength": 500,
"type": "string"
},
"prompt": {
"description": "Describe what happens after the opening frame: the action, the camera, and the mood.",
"maxLength": 1500,
"minLength": 1,
"type": "string"
},
"resolution": {
"default": "720p",
"description": "Output resolution.",
"enum": [
"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"
},
"shot_type": {
"default": "single",
"description": "Single continuous shot, or a multi-shot edit.",
"enum": [
"single",
"multi"
],
"type": "string"
}
},
"required": [
"image_url"
],
"type": "object"
}Un risultato reale di Wan 2.6
The camera stays on the two of them through all three shots. Three shots cut from the one kitchen frame. 1. Close: the knife going through, her forearms dusted with flour. 2. Medium: the pan catches flame and lights both their faces. 3. Close: he comes up behind her and reaches past her waist for the pan, her head tipping back against his shoulder, both shirts soaked through with steam. Cinematic, shallow depth of field, heavy film grain, kitchen steel and gas blue.
{
"model": "alibaba/wan-2.6/image-to-video",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1080p",
"duration_seconds": 10,
"shot_type": "single",
"prompt": "The camera stays on the two of them through all three shots. Three shots cut from the one kitchen frame. 1. Close: the knife going through, her forearms dusted with flour. 2. Medium: the pan catches flame and lights both their faces. 3. Close: he comes up behind her and reaches past her waist for the pan, her head tipping back against his shoulder, both shirts soaked through with steam. Cinematic, shallow depth of field, heavy film grain, kitchen steel and gas blue."
}
}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 -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-2.6/image-to-video",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5,
"shot_type": "single"
}
}'Stesso corpo di createTask. Restituisce l’addebito previsto e quello massimo possibile, senza eseguire nulla.
Accettata
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 "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
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "alibaba/wan-2.6/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"
}Scarica dall’url prima di expiresAt. Ti serve un link nuovo più tardi? Chiedilo con POST /common/download-url.
Verifica una callback
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 -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.

