Personal Workspace
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| person_image | string | Required | URL of the person/model image |
| garment_image | string | Required | URL of the garment/clothing image |
| video_model | string | Required | Video generation model (see supported models below) |
| prompt | string | Optional | Video motion description (default: natural walking) |
| duration | number | Optional | Video duration: 5 or 10 seconds (default: 5) |
| webhook_url | string | Optional | URL to receive completion webhook |
Supported Video Models
| Model ID | Name | Credits |
|---|---|---|
| seedance-1-5-i2v | Seedance 1.5 Pro | 25 + 5 (try-on) |
| kling-2-5-i2v | Kling 2.5 | 42 + 5 (try-on) |
| kling-2-6-i2v-pro | Kling 2.6 Pro | 50 + 5 (try-on) |
| wan-2-5-i2v | Wan 2.5 | 42 + 5 (try-on) |
| wan-2-6-i2v | Wan 2.6 | 42 + 5 (try-on) |
| veo-3-1-i2v | Veo 3.1 | 85 + 5 (try-on) |
| sora-2-i2v | Sora 2 | 100 + 5 (try-on) |
| sora-2-pro-i2v | Sora 2 Pro | 150 + 5 (try-on) |
Total credits = Video model credits + 5 credits for try-on image generation
Example Request
curl -X POST "https://api.hypereal.tech/v1/virtual-tryon" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"person_image": "https://example.com/person.jpg",
"garment_image": "https://example.com/garment.jpg",
"video_model": "seedance-1-5-i2v",
"prompt": "The model walks elegantly showing the outfit",
"duration": 5
}'Response
The API returns immediately with a job ID. Poll the pollUrl to check status.
Processing Response
{
"status": "processing",
"jobId": "task_abc123",
"tryonImageUrl": "https://cdn.hypereal.tech/tryon/xxx.jpg",
"pollUrl": "/api/v1/jobs/task_abc123"
}Completed Response (from polling)
{
"status": "completed",
"outputUrl": "https://cdn.hypereal.tech/videos/xxx.mp4",
"tryonImageUrl": "https://cdn.hypereal.tech/tryon/xxx.jpg",
"jobId": "task_abc123"
}How It Works
1
Try-On Image Generation
AI combines person and garment images to create a realistic try-on image using Qwen Image Edit.
2
Video Generation
The try-on image is animated using your selected video model to create natural movement.
3
Result Delivery
Poll the job status or receive a webhook when the video is ready.