alibaba/wan-3.0/text-to-videoDa 34 crediti per una clip di 5 secondi· Crea video

Wan 3.0 è la famiglia video di punta di Alibaba, pubblicata qui come API distinte: text-to-video, image-to-video, video-extend e reference-to-video.

Lo chiami con il nome di modello alibaba/wan-3.0/text-to-video su POST /jobs/createTask, da 34 crediti per una clip di 5 secondi (0,34 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 1080p
  • Clip da 2 a 30 s
  • Audio incluso
  • Fotogramma iniziale e finale
  • Fino a 10 immagini di riferimento
  • 5 formati
Nome del modelloalibaba/wan-3.0/text-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/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"

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

Prezzo

OpzioneCrediti al secondo≈ USD
resolution 480p6,750,068 USD
resolution 720p13,50,14 USD
resolution 1080p270,27 USD

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

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

Limiti

Durata della clip
2–30 s
Risoluzioni
480p · 720p · 1080p
Proporzioni
16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive

Parametri

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

  • promptstringObbligatorio

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

    Intervallo
    1 – … chars
  • aspect_ratiostringFacoltativo

    La forma dell'inquadratura: larga, quadrata o verticale.

    Predefinito
    "16:9"
    Valori ammessi
    "16:9""9:16""1:1""4:3""3:4""adaptive"
  • enable_thinkingbooleanFacoltativo

    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.

    Predefinito
    false
  • resolutionstringFacoltativoCambia il prezzo

    Dimensione dell'output. Più grande è più nitido e costa di più.

    Predefinito
    "720p"
    Valori ammessi
    "480p""720p""1080p"
  • 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
    false
  • seedintegerFacoltativo

    Lo stesso numero dà un risultato ripetibile.

    Intervallo
    0 – 2147483647
JSON Schema grezzo
{
  "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
}

Un risultato reale di Wan 3.0

PromptThe low camera slowly tracks backward as the giant translucent orange gummy bear takes a heavy step forward between the taxis, its jelly body jiggling and wobbling with each step, light glowing through it; rain keeps falling, pedestrians with blue umbrellas tilt their heads up, the cyclist in the yellow raincoat rides past through the foreground. Realistic physics, cinematic, no text.
La stessa richiesta tramite API
{
  "model": "alibaba/wan-3.0/text-to-video",
  "input": {
    "prompt": "The low camera slowly tracks backward as the giant translucent orange gummy bear takes a heavy step forward between the taxis, its jelly body jiggling and wobbling with each step, light glowing through it; rain keeps falling, pedestrians with blue umbrellas tilt their heads up, the cyclist in the yellow raincoat rides past through the foreground. Realistic physics, cinematic, no text.",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}

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

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

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.