Apimart
Log inSign Up
How to Use Wan 2.7: Beginner AI Video Tutorial

How to Use Wan 2.7: Beginner AI Video Tutorial

Learn how to use Wan 2.7 on APIMart to generate AI videos — set up your API key, then master Text-to-Video, Image-to-Video, and editing modes step by step.

Tutorial

Want to create AI-generated videos without a steep learning curve? Wan 2.7, Alibaba's latest AI video generator, makes it easy to produce high-quality, short video clips in just minutes. Accessible via APIMart, this tool supports Text-to-Video, Image-to-Video, Video Editing, and Reference-to-Video modes, offering flexibility for different projects.

Here's a quick rundown of what you'll learn:

  • Set up APIMart: Create an account, get an API key, and start with pay-as-you-go pricing (as low as $0.0664/second for 720p).
  • Core features: Generate videos from text, animate still images, or edit existing footage.
  • Step-by-step guide: Craft effective prompts, choose the right mode, and fine-tune results.

With no need for advanced hardware and a straightforward cloud-based workflow, you can start experimenting today. Let's dive in!

Setting Up Wan 2.7 via APIMart

Wan 2.7 setup on the GccAi dashboard for AI video generation

Creating Your APIMart Account

Head over to apimart.ai and create a free account or organization. Once you're in, go to API Key Management to generate your unique API key. Make sure to copy and securely store the key right away - it's displayed only once. You'll need this key as a Bearer Token in the Authorization header for every API request.

Don't forget to add funds to your account before starting. APIMart uses a pay-as-you-go model, so you'll only pay for what you use - no subscriptions required.

After setting up your account and ensuring it's funded, you're ready to confirm the system requirements.

System Requirements

You don't need a high-powered computer because all video processing happens in the cloud. Here's what you'll need:

RequirementDetails
BrowserAny modern browser like Chrome, Firefox, or Edge
InternetA stable connection for API calls and downloading videos
StorageEnough space to save .mp4 files (download links expire after 24 hours)
ToolsAny HTTP client, such as cURL, Postman, Python, or Node.js

Make sure to download videos within 24 hours to avoid losing access to the files.

Now, let's move on to locating Wan 2.7 on APIMart.

Finding Wan 2.7 on APIMart

Finding Wan 2.7 is simple. You can go directly to apimart.ai/model/wan-2-7 or find it in the API reference section of your dashboard. The platform offers three versions of the model: wan2.7, wan2.7-r2v, and wan2.7-videoedit. Each one serves a unique purpose, but they all share the same pricing: $0.0664 per second at 720p and $0.1096 per second at 1080p [2].

Before diving into coding, take advantage of the built-in Playground. This tool lets you experiment with prompts and fine-tune parameters. It's a quick way to see how the model performs before integrating it into your project. Videos are usually ready in 30 to 90 seconds and come with a 99.9% uptime SLA [2]. Once your API key is saved and your account is funded, you're all set to start generating videos.

Core Features of Wan 2.7

Wan 2.7 Video Modes Compared: Inputs, Use Cases & Pricing
Wan 2.7 Video Modes Compared: Inputs, Use Cases & Pricing

Now that your account is set up, let's dive into the core features of Wan 2.7. Designed to enhance your video creation process, Wan 2.7 offers three main modes: Text-to-Video, Image-to-Video (with sub-modes), and Video Editing. Each provides a unique starting point for your projects.

Text-to-Video: From Words to Visuals

Text-to-Video (T2V) is the simplest way to create video content. Just write a detailed description, and Wan 2.7 generates a video clip of up to 15 seconds in 1080p HD at 30fps. The tool can handle complex prompts that include subjects, motion, lighting, and camera instructions all at once.

To get the best results, structure your prompt as follows: [Subject] + [Action/Motion] + [Environment] + [Lighting] + [Camera] + [Style/Mood]. For example: "A barista pours latte art in a cozy café, with warm amber lighting, a slow push-in, cinematic style."

Here are some tips for crafting effective prompts:

  • Be specific with camera movements like "slow pan left" or "orbit."
  • Use active verbs like "pours" or "walks" rather than vague adjectives.
  • Add a negative prompt (e.g., "blurry, distorted, static") to minimize unwanted artifacts.
  • For short prompts, enable the prompt_extend option to automatically enrich your description for improved quality [3].

"The prompt is the script. When you want the best prompts for Wan 2.7, you are really designing beats, lenses, and sound in plain language." - Ryan Barnett, Tech Writer [9]

To save costs, start drafts at 720p ($0.0664/sec) before finalizing in 1080p ($0.1096/sec) [2]. Next, let's look at how Image-to-Video mode uses visuals to create seamless animations.

Image-to-Video and First-Last Frame Animations

Image-to-Video (I2V) mode brings still images to life while preserving their appearance and composition. Simply provide one or two image URLs via the image_urls parameter, and APIMart automatically processes your request in I2V mode [3].

This mode includes two sub-options:

  • First-Frame to Video: Start with a single image, and the model generates forward motion from that frame. Great for animating product photos, portraits, or illustrations.
  • First-Last Frame: Provide two images - one for the beginning and one for the end. The model creates a smooth transition between them, offering precise control over the animation.

When using I2V, focus your prompts on motion and camera behavior, as the images already define the visuals. For example: "slow zoom out", "eyes blink gently", "camera drifts right."

Illustrator Ming Li shared their experience with this feature:

"The image-to-video feature saved me so much post-production time. I just provide the keyframes and let WAN 2.7 do the rest." [2]

Another advantage: the aspect ratio is automatically set based on the input image dimensions, so there's no need for manual adjustments [3]. When you need to tweak existing footage instead of starting from scratch, the Video Editing mode is the way to go.

Video Editing and Restyling

The wan2.7-videoedit model allows you to modify existing video clips using plain language instructions. Instead of creating a new scene, you simply describe the changes you want - like "replace the background with a sunset beach" or "slow down the camera pan" - and the model applies them while keeping the rest of the footage intact [1].

For the best results, use direct action verbs such as replace, remove, brighten, slow, restyle. Be clear about what should remain unchanged to avoid unintended edits. For example: "Replace the background with a forest. Keep the subject and lighting unchanged." This level of clarity minimizes errors [7].

Additionally, the video_urls parameter supports video continuation, which lets you extend an existing clip naturally. This is perfect for lengthening sequences without the need to re-record or create new prompts [3].

"WAN 2.7 is about steering the clip... Wan 2.6 was about getting a clip." - MkSaaS, Tutorial Author [1]

Here's a quick summary of when to use each mode and the inputs required:

ModeInputBest For
Text-to-VideoText prompt onlyGenerating new scenes from scratch
Image-to-Video (First-Frame)1 image in image_urlsAnimating a photo or illustration
First-Last Frame2 images in image_urlsControlling start and end of a shot
Video ContinuationExisting clip in video_urlsExtending a video sequence
Video EditingSource video + edit instructionsRestyling or modifying existing footage

Step-by-Step: Creating Your First Video with Wan 2.7

Choosing the Right Mode

Wan 2.7 offers multiple modes tailored to different types of video creation. Here's how to choose the right one for your project:

  • T2V (Text-to-Video): Ideal for turning ideas into visual clips.
  • I2V (Image-to-Video): Animate photos into dynamic sequences.
  • Video Editing: Modify and enhance existing footage. For alternative high-fidelity results, you might also explore MiniMax-Hailuo-02.
  • R2V (Reference-to-Video): Use mixed-media inputs like images, video clips, or audio to ensure consistency across your video.

If you're unsure, APIMart will automatically select the appropriate mode based on your input. For advanced projects, the wan2.7-r2v model ID allows up to 5 mixed references, giving you more control over the final output.

Preparing Your Inputs and Settings

Before diving in, make sure your inputs and settings are ready. Here's a quick guide:

  1. Craft Your Prompt: Structure it as: [Subject] + [Action] + [Environment] + [Camera Move] + [Speed] + [Style].
    Example: "A chef plates a dish in a modern kitchen, warm overhead lighting, slow push-in, cinematic."

    • If your prompt is under 30 words, enable prompt_extend to add cinematic details automatically.
  2. Asset Requirements:

    • Use public HTTPS URLs for images/videos.
    • For editing or continuation, files must be in MP4 or MOV format, 2–10 seconds long, and under 100MB.
  3. Set Core Parameters:
    Adjust these key settings for optimal results:

    ParameterRecommended ValueNotes
    resolution720PUse 1080P for final renders only.
    duration5Ranges from 2–15 seconds (T2V/I2V).
    size16:9Applies to T2V; I2V auto-detects size.
    negative_prompt"blurry, distorted, low quality"Helps reduce common visual issues.
    seedAny non-negative integerSave this for consistent results.

    Starting with 720P resolution can save you about 39% per second - $0.0664/sec compared to $0.1096/sec for 1080P on APIMart.

Making Your First API Call

Video generation on APIMart works asynchronously. Here's how it flows:

  1. Submit Your Request: Send a JSON request, like this minimal T2V example:

    {
      "model": "wan2.7",
      "prompt": "A chef plates a dish in a modern kitchen, warm overhead lighting, slow push-in, cinematic.",
      "resolution": "720P",
      "duration": 5,
      "size": "16:9",
      "negative_prompt": "blurry, distorted, low quality",
      "prompt_extend": true
    }
    
  2. Get a task_id: You'll receive a task_id to track progress.

  3. Poll for Status: Check the status endpoint every 15 seconds. Once the status updates to SUCCEEDED, download your video immediately - the URL expires after 24 hours.

After downloading, you can review and refine your video as needed.

Reviewing and Adjusting Your Results

Once your video is ready, it's time to fine-tune it. Watch the clip carefully for issues like motion drift (where the subject changes mid-clip) or static movement. Use these tips to improve your results:

  • Tweak Variables: Adjust one element at a time, such as the camera cue, action verb, or duration. This method helps you identify what works best without overhauling the whole prompt.
  • Lock the Seed: Save the seed value from a successful result. This ensures you can reproduce the same output later.

"Lock [the seed] once you find a good output. It's the one parameter that makes your results reproducible across runs." - Dora, WaveSpeed Blog

For clips that feel too static, try adding cinematic terms like "dolly in", "slow push", or "handheld." If you need to modify a specific part of the video, switch to wan2.7-videoedit and provide clear instructions, such as "replace the background with a forest, keeping the subject and lighting unchanged." This way, you can refine specific elements without starting over.

Troubleshooting and Tips

When working on your video projects, you might run into a few hurdles. Below, you'll find solutions to common problems and practical advice to improve your results.

Common Problems and How to Fix Them

Many Wan 2.7 issues stem from setup missteps. Here's a quick guide to common problems and their fixes:

ProblemLikely CauseFix
Request fails entirelyRegion mismatchEnsure your API key and endpoint URL are from the same region [5]
Video looks like a still photoInsufficient motion in promptInclude action verbs like "turns head" or camera directions like "dolly forward" [8]
Subject changes mid-clipOverloaded promptSimplify to focus on one subject, one action, and one location [8]
400 error on submissionParameter conflictAvoid sending audio_url along with image_urls or video_urls [3]
Can't access the video URLLink expiredDownload the video within 24 hours of generation [5][2]

File Requirements: Input videos for continuation must be MP4 or MOV format, between 2–10 seconds, and under 100MB. Audio files need to be WAV or MP3, under 15MB [3]. Files that don't meet these criteria may fail silently or trigger a 400 error.

Once you've addressed these common issues, you can focus on fine-tuning your videos for better results.

Tips for Better Video Quality

The quality of your prompt directly impacts your video. A well-structured prompt delivers better results. Use the formula: [Subject] + [Action] + [Environment] + [Lighting] + [Camera] + [Style/Mood] [6]. This ensures the model has enough context to create a purposeful output.

For Image-to-Video mode, center your prompt on what should move and how the camera should behave. Avoid re-describing the wan2.7 image itself. If specific elements need to stay consistent, such as a product's shape or color, make that clear in the prompt to prevent distortions.

Start drafting at 720P resolution. Once you're happy with the motion, upgrade to 1080P for the final render [2].

In First-Last Frame mode, the quality of your input images matters more than the text prompt. For the best results, use a pair of images with a clear spatial relationship. A well-matched pair will produce more consistent outputs than even the most refined text prompt [4].

Using Wan 2.7 Responsibly

Wan 2.7, available on APIMart, is licensed for commercial use, making it a great tool for professional projects [2]. However, it's important to follow ethical guidelines. Avoid using identifiable images or audio of real people without explicit permission. If you're using reference images or videos, make sure you have the rights to use them.

APIMart also includes a watermark boolean parameter, which allows you to add an "AI Generated" label to your videos [3]. Enabling this for public-facing content is a simple way to stay transparent about AI involvement. For projects requiring different cinematic styles, you might also explore Google's Veo 3.1 API.

Conclusion

You're now equipped with the essentials to create your first AI-generated video using Wan 2.7. The steps are simple: set up your APIMart account, add funds, grab your API key, and start experimenting with a basic Text-to-Video request at 720P resolution. This approach keeps costs manageable while you get familiar with the process.

Take it step by step: start with short 5-second clips, note the seed values from successful outputs, and gradually move on to longer, higher-quality videos. Over time, you'll gain a better understanding of which mode suits your needs best - whether it's Text-to-Video for generating original scenes, Image-to-Video to bring a specific visual to life, or First-Last Frame for precise control over clip start and end points.

At $0.0664 per second for 720P and $0.1096 per second for 1080P via APIMart - a 20% discount compared to the official price [2] - a 5-second test clip at 720P comes in under $0.34. It's an affordable way to kick off your creative journey.

FAQs

How do I keep characters consistent across multiple clips?

To maintain consistent character design in Wan 2.7, leverage the Reference-to-Video (R2V) feature. Here's how you can do it effectively:

  • Provide up to five high-quality reference images or video clips. These should showcase the character from different perspectives, such as front, side, and three-quarter views. This variety helps the system understand the character's appearance more comprehensively.
  • When writing your text prompt, refer to these assets by their assigned index (e.g., "image 1" or "clip 2"). Clear references ensure precise results.
  • For more intricate setups, consider creating a 9-grid reference panel. This grid can display multiple angles or expressions, giving the system a broader understanding of the character. Pair this with consistent and detailed descriptions in every prompt for the best outcomes.

By combining visual references with well-crafted prompts, you can achieve a uniform and polished character representation.

What should I do if my video has weird motion or flicker?

To address motion or flicker problems in your videos, you can use a negative prompt to minimize unwanted artifacts like blur or jitter. This technique helps refine the output for a smoother result.

For image-to-video transitions, start with a clean source image - avoid using one with a cluttered or busy background, as this can introduce instability. If you notice flickering mid-clip, it's often due to inconsistent lighting or changes in focal distance. Keeping these elements steady is key to reducing disruptions.

Additionally, simplifying your prompt or limiting camera movement can go a long way in maintaining smooth and stable motion throughout your video.

How can I estimate my cost before generating a clip?

To calculate your video cost on APIMart, simply multiply the duration of your clip by the per-second rate for the resolution you've selected. Wan 2.7 follows a straightforward pricing model based on your output settings. Reviewing the pricing details ahead of time can help you plan your budget more effectively. Keep in mind, though, that these calculations are just estimates - your final cost will be determined by the actual output generated by the model.

Ready to build?

Choose the model you want in the model marketplace

Try chat, image and video models in the APIMart model marketplace, and experience model capabilities quickly with one unified API.

Chat modelsImage modelsVideo models
Explore model marketplace