Documentation

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

endpointYour webhook URL
secretWebhook secret for verification
Code 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 fields
401
Invalid or missing API key
413
Image file too large (max 10MB)
429
Rate limit exceeded
Rate 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