API Documentation
Wanx 2.1 - Text-to-Video
Generate high-quality videos from text descriptions using lightweight or advanced models
txt2video-1.3b
Lightweight
$0.12 per generation
Fast and cost-effective text-to-video generation for quick iterations and previews.
txt2video-14b
Advanced
$0.28 per generation
High-quality text-to-video generation with advanced understanding and detail.
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
Complete parameter documentation for text-to-video generation
Required
model
string
The model identifier for Wanx video generation
"Qubico/wanx"
task_type
string
The specific text-to-video task type
"txt2video-1.3b" | "txt2video-14b"
prompt
string
Detailed description of the video content to generate
"A girl with a playful smile leans forward..."
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
Lightweight Model (txt2video-1.3b)
{ "model": "Qubico/wanx", "task_type": "txt2video-1.3b", "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" }, "config": { "webhook_config": { "endpoint": "https://your-webhook.com/callback", "secret": "your_webhook_secret" } } }
Advanced Model (txt2video-14b)
{ "model": "Qubico/wanx", "task_type": "txt2video-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" }, "config": { "webhook_config": { "endpoint": "https://your-webhook.com/callback", "secret": "your_webhook_secret" } } }
Video Specifications
Technical Specs
- • Frames: 85 frames per video
- • Steps: 30 inference steps
- • Resolution: 480p
- • Aspect Ratios: 16:9 (default), 9:16
Best Practices
- • Use detailed, specific prompts for better results
- • Include camera movement descriptions
- • Use negative prompts to avoid unwanted elements
- • Configure webhooks for async processing
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 key429
Rate limit exceeded500
Internal server errorRate Limits & Pricing
Rate Limits
- • 10 requests per minute
- • 100 requests per hour
- • 1000 requests per day
Pricing
- • txt2video-1.3b: $0.12 per generation
- • txt2video-14b: $0.28 per generation
- • Processing time: 60-120 seconds