API-Schlüssel holen

von Alibaba

Ein Figurenfoto mit einem Referenzvideo bewegen

alibaba/wan-2.2-animate/character-animationAb 7,95 Creditspro Sekunde · 0,08 $
  • Bis 720p
  • Bewegungssteuerung
Beispiele ansehen

Du rufst es mit dem Modellnamen alibaba/wan-2.2-animate/character-animation über POST /jobs/createTask auf, ab 7,95 Credits pro Sekunde (0,08 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

Modellnamealibaba/wan-2.2-animate/character-animation
EndpunktPOST 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-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "720p"
  }
}'

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

Der input ist aus dem Schema unten gebaut und besteht die Prüfung so, wie er dasteht. Ersetz Prompt und Links durch deine eigenen.

Preis

OptionCredits pro Sekunde≈ USD
resolution 480p7,950,08 $
resolution 720p16,50,17 $

1 Credit = 0,01 $ · Alle Optionen und Preise: GET /models/alibaba/wan-2.2-animate/character-animation

Limits

Auflösungen
480p · 720p
Prompt-Länge (Zeichen)
2,000
Größter Upload
90 MB

Parameter

Diese Felder stammen aus demselben Schema, gegen das wir jede Anfrage prüfen. Nicht aufgeführte Felder werden abgelehnt.

  • image_urlstringPflicht

    Das Bild, von dem aus es losgeht.

    Bereich
    1 – … chars · image/jpeg, image/png, image/webp, image/gif
  • video_urlstringPflicht

    Der Clip, der bearbeitet wird.

    Bereich
    1 – … chars · video/mp4, video/webm, video/quicktime · ≤ 90 MB
  • animation_modestringOptional

    animate drives the character in the image with the motion of the driving video; replace swaps the person in the driving video for the one in the image.

    Standardwert
    "animate"
    Erlaubte Werte
    "animate""replace"
  • resolutionstringOptionalÄndert den Preis

    Ausgabegröße. Größere Formate sind schärfer und kosten mehr.

    Standardwert
    "720p"
    Erlaubte Werte
    "480p""720p"
  • promptstringOptional

    Optional description of the motion, used to guide animation style and content.

    Bereich
    0 – 2000 chars
  • seedintegerOptional

    Dieselbe Zahl liefert ein wiederholbares Ergebnis.

    Bereich
    0 – 2147483647
Rohes JSON-Schema
{
  "additionalProperties": false,
  "properties": {
    "animation_mode": {
      "default": "animate",
      "description": "animate drives the character in the image with the motion of the driving video; replace swaps the person in the driving video for the one in the image.",
      "enum": [
        "animate",
        "replace"
      ],
      "type": "string"
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Character image. The person in this image is the one that gets animated.",
      "minLength": 1,
      "type": "string"
    },
    "prompt": {
      "description": "Optional description of the motion, used to guide animation style and content.",
      "maxLength": 2000,
      "type": "string"
    },
    "resolution": {
      "default": "720p",
      "description": "Output video resolution.",
      "enum": [
        "480p",
        "720p"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed; zero requests a random seed.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    },
    "video_url": {
      "contentMediaType": [
        "video/mp4",
        "video/webm",
        "video/quicktime"
      ],
      "description": "Driving video, 2 to 30 seconds long; upload an MP4, or pass an MP4 or MOV URL. Its motion is transferred to the character and its length sets the output length. Videos outside that range are rejected before any charge.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "image_url",
    "video_url"
  ],
  "type": "object"
}

Ein echtes Ergebnis von Wan 2.2 Animate

Dieselbe Anfrage über die API
{
  "model": "alibaba/wan-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "720p"
  }
}

Dieses Ergebnis startete mit einer hochgeladenen Datei: Setz deinen eigenen Link dort ein, wo der Beispiel-Link steht.

Antworten, Polling und Callbacks

Alle Modelle funktionieren gleich: Task anlegen, dann pollen oder auf den Callback warten.

Erst den Preis prüfen

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-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "720p"
  }
}'

Gleicher Body wie bei createTask. Liefert die erwartete und die höchstmögliche Abbuchung und startet nichts.

Angenommen

HTTP
HTTP/1.1 202 Accepted

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

HTTP 202 heißt: Der Task ist angenommen, die Credits sind reserviert, aber noch nicht abgebucht. Die endgültige Abbuchung liegt nie über der Reservierung.

Status abfragen

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

Frag alle paar Sekunden mit wachsendem Abstand ab und hör auf, sobald state succeeded, failed, canceled oder expired ist.

Fertiger Task

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

Lad über die url vor expiresAt herunter. Später einen frischen Link nötig? Frag POST /common/download-url.

Callback prüfen

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

Mit gesetzter callBackUrl schicken wir dir den fertigen Task. Prüf die Signatur am rohen Body, bevor du ihm vertraust.

Lokale Datei schicken

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.

Öffentliche https-Links funktionieren direkt. Lokale Dateien laufen vorher über upload-url und commit.