API Documentation
Wanx 2.1 - Image-to-Video
Transform static images into dynamic videos with motion and animation
img2video-14b
$0.28 per generation
The img2video-14b model transforms static images into dynamic videos by adding motion, animation, and temporal consistency. Perfect for bringing photographs, artwork, and illustrations to life.
Image Input
URL or base64 format
Video Output
85 frames, 480p
Motion Control
Prompt-driven animation
Quick Start
1
Base URL
https://api.qubico.ai/v1/task
2
Header Params
X-API-Key: YOUR_API_KEY
3
Model ID
Qubico/wanx
Parameters Reference
Required
model
string
The model identifier for Wanx video generation
"Qubico/wanx"
task_type
string
The image-to-video task type
"img2video-14b"
image
string
Input image URL or base64 encoded string
"https://your-image.com/image.jpg"
prompt
string
Description of the motion and animation to apply
"The camera slowly zooms out, capturing the anticipation..."
Optional
negative_prompt
string
Description of what to avoid in the generated video
"chaotic, distortion, morphing, blurred details"
aspect_ratio
string
Video aspect ratio (default: "16:9")
"16:9" | "9:16"
Configuration
webhook_config
object
Webhook configuration for async notifications
endpoint
Your webhook URLsecret
Webhook secret for verificationCode Examples
Image-to-Video Request
{ "model": "Qubico/wanx", "task_type": "img2video-14b", "input": { "prompt": "A girl with a playful smile leans forward on the ferry railing, holding onto her sunhat as the wind threatens to carry it away. She looks directly at the camera with bright, excited eyes, her laughter almost visible in her expression. The sun reflects off the sparkling water, and behind her, the coastline of a charming island town approaches. The camera slowly zooms out, capturing the anticipation of arrival.", "negative_prompt": "Overexposure, static, blurred details, subtitles, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, mutilated, redundant fingers, poorly painted hands, poorly painted faces, deformed, disfigured, deformed limbs, fused fingers, three legs", "aspect_ratio": "16:9", "image": "https://your-image.com/image.jpg" }, "config": { "webhook_config": { "endpoint": "https://your-webhook.com/callback", "secret": "your_webhook_secret" } } }
Image Requirements
Supported Formats
- • URL links to publicly accessible images
- • Base64 encoded image data
- • Common formats: JPG, PNG, WebP
- • Maximum file size: 10MB
Best Practices
- • Use clear, high-quality images
- • Avoid heavily compressed images
- • Ensure good lighting and contrast
- • Minimize background distractions
Response Format
{ "task_id": "task_12345", "status": "pending", "message": "Task submitted successfully", "estimated_time": "60-120 seconds" }
Error Handling
Common Error Codes
400
Invalid parameters or missing required fields401
Invalid or missing API key413
Image file too large (max 10MB)429
Rate limit exceededRate Limits & Pricing
Rate Limits
- • 10 requests per minute
- • 100 requests per hour
- • 1000 requests per day
Pricing
- • img2video-14b: $0.28 per generation
- • Processing time: 60-120 seconds
- • Video output: 85 frames, 480p