Wan 2.2 Animate Move Webhook Guide — Async Task Callbacks
Use Wan 2.2 Animate Move webhooks when your app cannot keep a browser or server request open while a lip sync task completes. Submit the task to `https://www.lithovas.com/api/generate` with `webhook_url`, store the returned task id, and treat polling as a fallback. Pricing is pay-per-use pricing and failed generations cost $0.
Create a task with webhook_url
Send the generation request from your backend and include a callback URL that your app controls.
curl -X POST https://www.lithovas.com/api/generate \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan/2-2-animate-move","input":{"prompt":"A cinematic product shot"},"webhook_url":"https://your-app.com/webhooks/97ai"}'
Task state machine
| State | Meaning | Action |
|---|---|---|
| PENDING | Task accepted and queued | Store taskId and show an in-progress state |
| SUCCESS | Generation completed | Save resultUrls, creditsConsumed, and prompt metadata |
| FAILURE | Generation failed upstream | Show the error and keep billing at $0 for the failed task |
Webhook handler checklist
- Accept only POST requests at your callback URL.
- Verify the task id exists in your database before updating state.
- Make the handler idempotent; the same terminal event may be delivered more than once.
- Store `resultUrls`, final state, credits consumed, and the original prompt metadata.
- Keep polling `GET https://www.lithovas.com/api/generate/{taskId}` as a fallback if your callback endpoint is unavailable.
Frequently asked questions
Does Wan 2.2 Animate Move support webhooks?+
Yes. Include `webhook_url` when you create the Wan 2.2 Animate Move generation task through 97AI.PRO.
Should I use polling or webhooks for Wan 2.2 Animate Move?+
Use webhooks for production and polling for local testing or fallback recovery. Both patterns can coexist safely.
What happens if my webhook endpoint is down?+
Keep the task id and poll the task details endpoint. Your result remains available after the generation finishes.
Are failed Wan 2.2 Animate Move tasks billed?+
No. Failed tasks cost $0 under 97AI.PRO's zero-risk billing policy.
Can I use a localhost webhook while developing?+
Use a tunnel such as ngrok or Cloudflare Tunnel so 97AI.PRO can reach your local callback endpoint.
Ready to try Wan 2.2 Animate Move?
Sign up on 97AI.PRO, top up with credit card / USDC / Alipay, and get an API key in under 60 seconds.