How do I handle polling and timeouts for long-running video tasks?

Submit the task, keep the taskid, and poll GET /v1/tasks/{taskid} every 10 seconds until the status is completed, failed or cancelled. Generation usually takes 1–5 minutes, so give your polling loop an overall timeout instead of waiting on a single request. To avoid overloading the API, handle 429 errors by pausing and retrying after a delay. Once the task completes, download the video right away, because APIMart keeps results for 72 hours.

What’s the best way to estimate cost before generating a 5s or 10s clip?

To figure out the cost of a 5-second or 10-second video clip, simply multiply the clip's duration (in seconds) by the provider's per-second rate. Make sure to check the rate for the resolution you want - whether it's 480p, 720p, or 1080p - since higher quality usually comes with a higher price. For example, if you're calculating for a 5-second clip, multiply the per-second rate by 5. For a 10-second clip, multiply it by 10.

How can I improve lip-sync and dialogue quality with my prompts?

To get the best lip-sync and dialogue quality in Wan 2.5 Preview, use structured prompts. These should clearly specify the character's lines, along with details like emotion, tone, speed, and timbre. This level of detail helps the model deliver more accurate and natural results. For even greater precision, you can upload a custom audio file in WAV or MP3 format. This file will act as a guide for the model to align facial expressions and mouth movements with the audio perfectly. Make sure your input image is sharp and well-lit. A high-quality image ensures the model can interpret and replicate expressions effectively. Additionally, take advantage of the prompt extension feature, which allows you to include detailed descriptions for better interpretation by the model.

How to Get Started with Wan 2.5 Preview

A quick Wan 2.5 Preview guide for developers — set up the API, write cinematic T2V and I2V prompts, add synced audio, and manage cost for 1080p video.

Tutorial

Wan 2.5 Preview is a video generation tool by Alibaba that turns text descriptions or images into short cinematic clips with synchronized audio. It supports two modes: text-to-video (T2V) and image-to-video (I2V). Other high-performance models like Kling V3 offer similar cinematic capabilities. Key features include one-pass audio-visual creation, precise lip-syncing, and outputs up to 1080p at 24fps for 5- or 10-second videos. Integration is made easy through APIMart, a platform offering a unified API for seamless access. Pricing starts at $0.0336/second for 480p. Here's what you need to know to get started:

Modes: T2V for creating videos from text prompts, I2V for adding motion to images.
Quality: Outputs in 480p, 720p, or 1080p with 48kHz stereo audio.
Pricing: Pay-as-you-go, billed per second of video generated.
Setup: Works with Python or Node.js using a REST API. Requires an API key from APIMart.
Workflow: Submit a request, get a task ID, and poll for the result.

Start with a 5-second 480p clip to test your setup. Once comfortable, scale up to 1080p for final renders. Use detailed prompts for better results, and incorporate audio instructions for synchronized sound.

This guide covers everything from setting up your environment to crafting prompts and managing costs effectively.

Key Takeaways

Wan 2.5 Preview is Alibaba's video generation model that turns text or images into 5- or 10-second clips at up to 1080p and 24fps with synchronized 48kHz stereo audio.
Setup uses plain REST calls to https://api.apimart.ai with a Bearer API key from APIMart; a 401 error means a bad key and 402 means low balance.
Requests to wan2.5-preview (add image_urls for image-to-video) return a task_id that you poll until the status is completed; generation takes 1–5 minutes, and APIMart keeps the result for 72 hours (see expires_at).
Prompts of 80 to 120 words with camera terms, quoted dialogue, and sound cues work best; prompt_extend expands short prompts and a custom audio_url (.wav/.mp3, max 15 MB) is supported.
Pricing starts at $0.0336/second for 480p; draft at 480p for 5 seconds (43 credits), then render 1080p at 128 credits for 5 seconds or 255 credits for 10 seconds.
Source images for I2V must be 360 to 2,000 pixels per side and under 10 MB, and the output aspect ratio follows the source image.

Wan 2.5 Preview at a Glance

Specification	Details
Developer	Alibaba
Model type	Text-to-video (T2V) and image-to-video (I2V) with synchronized audio
Inputs	Text prompt; source image 360–2,000 px per side, max 10 MB; optional audio_url (.wav/.mp3, max 15 MB)
Output	MP4 at 480p, 720p, or 1080p, 24 fps
Clip length	5 or 10 seconds (fixed)