PopNowAPI
Obtenir une clé API

Wan 3.0 Plus API

par Alibaba

Wan 3.0 image vers vidéo, jusqu’à 30 secondes avec son

alibaba/wan-3.0-plus/image-to-video
  • Jusqu’à 1080p
  • Clips de 2 à 30 s
  • Son inclus
  • Image de début et de fin
  • 5 formats d’image
  • Image vers vidéo
  • Prolonger une vidéo

Appelez-le avec le nom de modèle alibaba/wan-3.0-plus/image-to-video sur POST /jobs/createTask, à partir de 0,285 $US.

Nom du modèlealibaba/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"

L’input est construit à partir du schéma ci-dessous : il passe la validation tel quel. Remplacez le prompt et les liens par les vôtres.

Prix

OptionUSD par seconde
resolution 480p0,057 $US
resolution 720p0,114 $US
resolution 1080p0,228 $US

Facturation en USD · Toutes les options et leur prix : GET /models/alibaba/wan-3.0-plus/image-to-video

Limites

Durée du clip
2–30 s
Résolutions
480p · 720p · 1080p
Formats d’image
16:9 · 9:16 · 1:1 · 4:3 · 3:4

Paramètres

Ces champs viennent du schéma avec lequel nous vérifions chaque requête. Les champs qui n’y figurent pas sont refusés.

Certains champs dépendent les uns des autres (par exemple, au moins une référence). Le schéma brut en bas de page donne les règles exactes.

  • image_urlstringObligatoire

    L’image de départ.

    Plage
    image/jpeg, image/png, image/webp, image/gif
  • promptstringFacultatif

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

    Plage
    1 – … chars
  • last_image_urlstringFacultatif

    Image finale facultative, pour que le clip se termine exactement où vous voulez.

    Plage
    image/jpeg, image/png, image/webp, image/gif
  • aspect_ratiostringFacultatif

    La forme du cadre : large, carrée ou verticale.

    Valeurs acceptées
    "16:9""9:16""1:1""4:3""3:4"
  • resolutionstringFacultatifModifie le prix

    Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher.

    Par défaut
    "720p"
    Valeurs acceptées
    "480p""720p""1080p"
  • duration_secondsintegerFacultatifModifie le prix

    La durée du clip. Facturée à la seconde.

    Par défaut
    5
    Valeurs acceptées
    23456789101112131415161718192021222324252627282930
  • generate_audiobooleanFacultatif

    Ajoute un son assorti à l’image : voix, ambiance et effets.

    Par défaut
    true
  • enable_prompt_expansionbooleanFacultatif

    Laisse le modèle enrichir un prompt court.

    Par défaut
    false
  • seedintegerFacultatif

    Le même nombre donne un résultat reproductible.

    Plage
    0 – 2147483647
Schéma JSON brut
{
  "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"
}

Réponses, interrogation et callbacks

Tous les modèles fonctionnent de la même façon : créez une tâche, puis interrogez-la ou attendez le callback.

Connaître le prix d’abord

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

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Acceptée

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202 signifie que la tâche est acceptée : le plafond en USD reste réservé jusqu’au décompte final. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

Vérifier l’état

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

Interrogez toutes les quelques secondes en espaçant progressivement, et arrêtez dès que state vaut succeeded, failed, canceled ou expired.

Tâche terminée

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

Téléchargez depuis l’url avant expiresAt. Besoin d’un nouveau lien plus tard ? Demandez-le à POST /common/download-url.

Vérifier 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
});

Avec une callBackUrl, nous vous envoyons la tâche terminée. Vérifiez la signature sur le corps brut avant de lui faire confiance.

Envoyer un fichier 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.

Les liens https publics fonctionnent tels quels. Les fichiers locaux passent d’abord par upload-url et commit.

À propos de Wan 3.0 Plus

Wan 3.0 image vers vidéo, jusqu’à 30 secondes avec son.

Appelez-le avec le nom de modèle alibaba/wan-3.0-plus/image-to-video sur POST /jobs/createTask, à partir de 0,285 $US.

Paramètres de requête

ParamètreRequisDescription
aspect_ratioNonLa forme du cadre : large, carrée ou verticale. 16:9 · 9:16 · 1:1 · 4:3 · 3:4
duration_secondsNonLa durée du clip. Facturée à la seconde. 2–30 · Par défaut: 5
enable_prompt_expansionNonLaisse le modèle enrichir un prompt court. Par défaut: false
generate_audioNonAjoute un son assorti à l’image : voix, ambiance et effets. Par défaut: true
image_urlOuiL’image de départ.
last_image_urlNonImage finale facultative, pour que le clip se termine exactement où vous voulez.
promptNonDescribe the subject, action, camera, light, pacing, and sound for the shot.
resolutionNonTaille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 480p · 720p · 1080p · Par défaut: 720p
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647

Tarifs

Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

OptionUSD par seconde
resolution 480p0,057 $US
resolution 720p0,114 $US
resolution 1080p0,228 $US

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Démarrage rapide de l'API

Appeler l’API Wan 3.0 Plus en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow-. Les appels API utilisent votre solde distinct en dollars américains.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model alibaba/wan-3.0-plus/image-to-video et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 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"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Wan 3.0 Plus

Combien coûte l’API Wan 3.0 Plus ?

Wan 3.0 Plus coûte à partir de 0,285 $US pour un clip de 5 secondes avec Image vers vidéo, sa tâche la moins chère. Prix par option : 480p 0,057 $US par seconde, 720p 0,114 $US par seconde, 1080p 0,228 $US par seconde. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

Quel est le nom de modèle de Wan 3.0 Plus dans l’API ?

Indiquez alibaba/wan-3.0-plus/image-to-video pour Image vers vidéo; alibaba/wan-3.0-plus/video-extend pour Prolonger une vidéo dans le champ model de POST /jobs/createTask.

Quelles sont les limites de l’API Wan 3.0 Plus ?

Durée du clip: 2–30 s; Résolutions: 480p · 720p · 1080p; Formats d’image: 16:9 · 9:16 · 1:1 · 4:3 · 3:4. Les requêtes hors de ces limites sont refusées avant tout débit.

En savoir plus sur Wan 3.0 Plus