alibaba/wan-3.0-prime/image-to-videoFrom 46 credits for a 5-second clip· Image to Video

Wan 3.0 Prime image-to-video animates an opening frame into 2 to 30 seconds with generated audio, at 480p, 720p or 1080p. An optional last frame pins the ending, and the prompt only needs to describe motion.

Call it with the model name alibaba/wan-3.0-prime/image-to-video on POST /jobs/createTask, from 46 credits for a 5-second clip ($0.46). New accounts get 30 free credits to try it in the Playground first.

  • Create Video
  • Image to Video
  • Reference to Video
  • Extend Video
  • Up to 1080p
  • 2–30s clips
  • Sound included
  • Start and end frames
  • Up to 10 reference images
  • 5 aspect ratios
Model namealibaba/wan-3.0-prime/image-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-prime/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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"

The input is built from the schema below, so it passes validation as written. Change the prompt and links to your own.

Price

OptionCredits per second≈ USD
resolution 480p9.18$0.092
resolution 720p18.9$0.19
resolution 1080p37.8$0.38

1 credit = $0.01 · Every option and its price: GET /models/alibaba/wan-3.0-prime/image-to-video

Each task is rounded up to whole credits, so one run at the lowest tier costs 46 credits for a 5-second clip ($0.46).

Limits

Clip length
2–30 s
Resolutions
480p · 720p · 1080p
Aspect ratios
16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive

Parameters

These fields come from the same schema we check every request against. Fields that are not listed are rejected.

Some fields depend on each other (for example, at least one reference). The raw schema at the bottom has the exact rules.

  • image_urlstringRequired

    The picture to start from.

    Range
    image/jpeg, image/png, image/webp, image/gif
  • promptstringOptional

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

    Range
    1 – … chars
  • last_image_urlstringOptional

    Optional final frame, so the clip ends exactly where you want.

    Range
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringOptional

    The shape of the frame: wide, square or tall.

    Allowed values
    "16:9""9:16""1:1""4:3""3:4""adaptive"
  • enable_thinkingbooleanOptional

    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.

    Default
    false
  • resolutionstringOptionalChanges the price

    Output size. Bigger sizes look sharper and cost more.

    Default
    "720p"
    Allowed values
    "480p""720p""1080p"
  • duration_secondsintegerOptionalChanges the price

    How long the clip runs. You pay per second.

    Default
    5
    Allowed values
    -123456789101112131415161718192021222324252627282930
  • generate_audiobooleanOptional

    Adds sound made to match the picture: voices, ambience and effects.

    Default
    true
  • enable_prompt_expansionbooleanOptional

    Lets the model add detail to a short prompt.

    Default
    false
  • seedintegerOptional

    Reuse the same number to get a repeatable result.

    Range
    0 – 2147483647
Raw JSON Schema
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "required": [
          "last_image_url"
        ]
      },
      "then": {
        "required": [
          "image_url"
        ]
      }
    }
  ],
  "properties": {
    "aspect_ratio": {
      "description": "Output aspect ratio. Omit it to let the task adapt to the opening image; adaptive follows the input media and the intent.",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4",
        "adaptive"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "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.",
      "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": false,
      "description": "Allow the service to expand the submitted creative brief before generation.",
      "type": "boolean"
    },
    "enable_thinking": {
      "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.",
      "type": "boolean"
    },
    "generate_audio": {
      "default": true,
      "description": "Request generated audio with the video.",
      "type": "boolean"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Opening-frame image.",
      "type": "string"
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional last frame: the clip ends exactly on this image. Requires image_url.",
      "type": "string"
    },
    "prompt": {
      "description": "Describe the subject, action, camera, light, pacing, and boundaries for the shot.",
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution.",
      "enum": [
        "480p",
        "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"
    }
  },
  "required": [
    "image_url"
  ],
  "type": "object"
}

Responses, polling and callbacks

Every model works the same way: create a task, then poll it or wait for a callback.

Price it first

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-prime/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

Same body as createTask. It returns the expected and the highest possible charge, and runs nothing.

Accepted

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202 means the task was accepted and the credits are held, not charged yet. The final charge never goes above the hold.

Check status

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

Poll every few seconds with backoff and stop once state is succeeded, failed, canceled or expired.

Finished task

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "alibaba/wan-3.0-prime/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"
}

Download from url before expiresAt. Need a fresh link later? Ask POST /common/download-url.

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

With callBackUrl set, we post the finished task to you. Check the signature against the raw body before you trust it.

Send a local file

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.

Public https links work as they are. Local files go through upload-url and commit first.