alibaba/wan-3.0-prime/text-to-videoDesde 46 créditos por un clip de 5 segundos· Crear videoWan 3.0 Prime es la versión rápida de Wan 3.0 de Alibaba y publica las mismas API distintas —text-to-video, image-to-video, video-extend y reference-to-video— con el mismo contrato de 2 a 30 segundos, 480p a 1080p y audio activado. Misma forma de solicitud y mismas capacidades que Wan 3.0; lo que cambia es una entrega más rápida a un precio por segundo más alto.
Llámalo con el nombre de modelo alibaba/wan-3.0-prime/text-to-video en POST /jobs/createTask, desde 46 créditos por un clip de 5 segundos (0,46 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.
- Crear video
- Imagen a video
- Referencias a video
- Extender video
- Hasta 1080p
- Clips de 2 a 30 s
- Con sonido
- Fotograma inicial y final
- Hasta 10 imágenes de referencia
- 5 relaciones de aspecto
alibaba/wan-3.0-prime/text-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-3.0-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"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"// 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-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"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-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"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"])El input se genera a partir del esquema de abajo, así que pasa la validación tal cual. Cambia el prompt y los enlaces por los tuyos.
Precio
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
resolution 480p | 9,18 | 0,092 US$ |
resolution 720p | 18,9 | 0,19 US$ |
resolution 1080p | 37,8 | 0,38 US$ |
1 crédito = 0,01 $ · Todas las opciones y su precio: GET /models/alibaba/wan-3.0-prime/text-to-video
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 46 créditos por un clip de 5 segundos (0,46 US$).
Límites
- Duración del clip
- 2–30 s
- Resoluciones
- 480p · 720p · 1080p
- Relaciones de aspecto
- 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive
Parámetros
Estos campos salen del mismo esquema con el que validamos cada petición. Los campos que no aparecen se rechazan.
promptstringObligatorioDescribe the subject, action, camera, light, pacing, and boundaries for the shot.
aspect_ratiostringOpcionalLa forma del encuadre: horizontal, cuadrado o vertical.
enable_thinkingbooleanOpcionalLet the model reason about the brief and the reference material before generating. Helps with complex references; slower. Switches on by itself when a reference file or link is given.
resolutionstringOpcionalCambia el precioTamaño de salida. Más grande es más nítido y cuesta más.
duration_secondsintegerOpcionalCambia el precioCuánto dura el clip. Se cobra por segundo.
generate_audiobooleanOpcionalAñade sonido acorde a la imagen: voces, ambiente y efectos.
enable_prompt_expansionbooleanOpcionalDeja que el modelo añada detalles a un prompt corto.
seedintegerOpcionalRepite el mismo número para obtener un resultado reproducible.
Esquema JSON sin procesar
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee."
},
"prompt": {
"type": "string",
"minLength": 1,
"description": "Describe the subject, action, camera, light, pacing, and boundaries for the shot."
},
"resolution": {
"enum": [
"480p",
"720p",
"1080p"
],
"type": "string",
"default": "720p",
"description": "Output resolution."
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4",
"adaptive"
],
"type": "string",
"default": "16:9",
"description": "Output aspect ratio; adaptive follows the input media and the intent."
},
"generate_audio": {
"type": "boolean",
"default": true,
"description": "Request generated audio with the video."
},
"enable_thinking": {
"type": "boolean",
"default": false,
"description": "Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Switches on by itself when a reference file or link is given."
},
"duration_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",
"default": 5,
"description": "Requested output length in seconds. Pass -1 for smart duration: the model picks the length from the prompt and any input media instead of a fixed number."
},
"enable_prompt_expansion": {
"type": "boolean",
"default": false,
"description": "Allow the service to expand the submitted creative brief before generation."
}
},
"additionalProperties": false
}Respuestas, consultas y callbacks
Todos los modelos funcionan igual: crea una tarea y luego consulta su estado o espera el callback.
Consulta el precio primero
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-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'El mismo cuerpo que createTask. Devuelve el cargo esperado y el máximo posible, sin ejecutar nada.
Aceptada
HTTP/1.1 202 Accepted
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued"
},
"request_id": "req_example_create"
}HTTP 202 significa que la tarea se aceptó y los créditos quedan reservados, todavía sin cobrar. El cargo final nunca supera la reserva.
Consultar estado
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Consulta cada pocos segundos espaciando cada vez más y para cuando state sea succeeded, failed, canceled o expired.
Tarea terminada
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "alibaba/wan-3.0-prime/text-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"
}Descarga desde la url antes de expiresAt. ¿Necesitas un enlace nuevo más tarde? Pídelo con POST /common/download-url.
Verificar un 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 te enviamos la tarea terminada. Comprueba la firma sobre el cuerpo sin procesar antes de fiarte de ella.
Enviar un archivo local
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.Los enlaces https públicos funcionan tal cual. Los archivos locales pasan antes por upload-url y commit.

