PopNowAPI
Consigue tu clave API

Wan 3.0 Plus API

de Alibaba

Wan 3.0 de imagen a video, hasta 30 segundos con audio

alibaba/wan-3.0-plus/image-to-video
  • Hasta 1080p
  • Clips de 2 a 30 s
  • Con sonido
  • Fotograma inicial y final
  • 5 relaciones de aspecto
  • Imagen a video
  • Extender video

Llámalo con el nombre de modelo alibaba/wan-3.0-plus/image-to-video en POST /jobs/createTask, desde 0,285 US$.

Nombre del modeloalibaba/wan-3.0-plus/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-plus/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"

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ónUSD por segundo
resolution 480p0,057 US$
resolution 720p0,114 US$
resolution 1080p0,228 US$

Facturación en USD · Todas las opciones y su precio: GET /models/alibaba/wan-3.0-plus/image-to-video

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

Parámetros

Estos campos salen del mismo esquema con el que validamos cada petición. Los campos que no aparecen se rechazan.

Algunos campos dependen entre sí (por ejemplo, al menos una referencia). El esquema completo de abajo tiene las reglas exactas.

  • image_urlstringObligatorio

    La imagen de partida.

    Rango
    image/jpeg, image/png, image/webp, image/gif
  • promptstringOpcional

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

    Rango
    1 – … chars
  • last_image_urlstringOpcional

    Fotograma final opcional, para que el clip termine justo donde quieres.

    Rango
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringOpcional

    La forma del encuadre: horizontal, cuadrado o vertical.

    Valores permitidos
    "16:9""9:16""1:1""4:3""3:4"
  • resolutionstringOpcionalCambia el precio

    Tamaño de salida. Más grande es más nítido y cuesta más.

    Por defecto
    "720p"
    Valores permitidos
    "480p""720p""1080p"
  • duration_secondsintegerOpcionalCambia el precio

    Cuánto dura el clip. Se cobra por segundo.

    Por defecto
    5
    Valores permitidos
    23456789101112131415161718192021222324252627282930
  • generate_audiobooleanOpcional

    Añade sonido acorde a la imagen: voces, ambiente y efectos.

    Por defecto
    true
  • enable_prompt_expansionbooleanOpcional

    Deja que el modelo añada detalles a un prompt corto.

    Por defecto
    false
  • seedintegerOpcional

    Repite el mismo número para obtener un resultado reproducible.

    Rango
    0 – 2147483647
Esquema JSON sin procesar
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "required": [
          "last_image_url"
        ]
      },
      "then": {
        "required": [
          "image_url"
        ]
      }
    }
  ],
  "properties": {
    "aspect_ratio": {
      "description": "Output aspect ratio. Omit it to let the clip adapt to the opening image; a ratio that differs from the image crops it.",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Requested output length in whole seconds.",
      "enum": [
        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"
    },
    "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 on this image. Requires image_url.",
      "type": "string"
    },
    "prompt": {
      "description": "Describe the subject, action, camera, light, pacing, and sound 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"
}

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

Antes de ejecutar, envía el mismo cuerpo de petición a POST /jobs/quote para consultar el coste estimado y el máximo en USD. El presupuesto no ejecuta tareas ni carga tu saldo.

Aceptada

HTTP
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 está aceptada: el máximo en USD queda reservado hasta la liquidación. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.

Consultar estado

cURL
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

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

Descarga desde la url antes de expiresAt. ¿Necesitas un enlace nuevo más tarde? Pídelo con POST /common/download-url.

Verificar un 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 te enviamos la tarea terminada. Comprueba la firma sobre el cuerpo sin procesar antes de fiarte de ella.

Enviar un archivo local

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.

Los enlaces https públicos funcionan tal cual. Los archivos locales pasan antes por upload-url y commit.

Acerca de Wan 3.0 Plus

Wan 3.0 de imagen a video, hasta 30 segundos con audio.

Llámalo con el nombre de modelo alibaba/wan-3.0-plus/image-to-video en POST /jobs/createTask, desde 0,285 US$.

Parámetros de la petición

ParámetroObligatorioDescripción
aspect_ratioNoLa forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · 1:1 · 4:3 · 3:4
duration_secondsNoCuánto dura el clip. Se cobra por segundo. 2–30 · Por defecto: 5
enable_prompt_expansionNoDeja que el modelo añada detalles a un prompt corto. Por defecto: false
generate_audioNoAñade sonido acorde a la imagen: voces, ambiente y efectos. Por defecto: true
image_urlSíLa imagen de partida.
last_image_urlNoFotograma final opcional, para que el clip termine justo donde quieres.
promptNoDescribe the subject, action, camera, light, pacing, and sound for the shot.
resolutionNoTamaño de salida. Más grande es más nítido y cuesta más. 480p · 720p · 1080p · Por defecto: 720p
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647

Precios

Los precios se indican en USD. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.

OpciónUSD por segundo
resolution 480p0,057 US$
resolution 720p0,114 US$
resolution 1080p0,228 US$

Antes de ejecutar, envía el mismo cuerpo de petición a POST /jobs/quote para consultar el coste estimado y el máximo en USD. El presupuesto no ejecuta tareas ni carga tu saldo.

Inicio rápido de la API

Llama a la API de Wan 3.0 Plus en tres pasos

  1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola API. Las claves empiezan por sk-popnow-. Las llamadas utilizan tu saldo independiente en dólares estadounidenses.
  2. Envía la solicitud. Haz POST /jobs/createTask con model alibaba/wan-3.0-plus/image-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
  3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 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-plus/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"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de Wan 3.0 Plus

¿Cuánto cuesta la API de Wan 3.0 Plus?

Wan 3.0 Plus cuesta desde 0,285 US$ por un clip de 5 segundos con Imagen a video, su tarea más barata. Precios por opción: 480p 0,057 US$ por segundo, 720p 0,114 US$ por segundo, 1080p 0,228 US$ por segundo. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.

¿Cuál es el nombre de modelo de Wan 3.0 Plus en la API?

Pon alibaba/wan-3.0-plus/image-to-video para Imagen a video; alibaba/wan-3.0-plus/video-extend para Extender video en el campo model de POST /jobs/createTask.

¿Qué límites tiene la API de Wan 3.0 Plus?

Duración del clip: 2–30 s; Resoluciones: 480p · 720p · 1080p; Relaciones de aspecto: 16:9 · 9:16 · 1:1 · 4:3 · 3:4. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

Más sobre Wan 3.0 Plus