Documentation

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

endpointYour webhook URL
secretWebhook secret for verification
Code 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 fields
401
Invalid or missing API key
429
Rate limit exceeded
500
Internal server error
Rate 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