Hunyuan AI - Image to Video

Transform static images into dynamic videos using Hunyuan AI's sophisticated image-to-video generation technology with specialized modes for different creative needs.

Note: Image files must first be uploaded using the Asset API before processing. The imageUrl parameter should contain the path returned from the Asset API upload.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Request Parameters

Field Name	Type	Example	Description	Required
type	string	IMAGE_TO_VIDEO	Feature identifier	✔️
model	string	Qubico/hunyuan	AI model to use	✔️
conversationId	string	IMAGE_TO_VIDEO	Conversation context	✔️
promptObject.imageUrl	string	images/example.jpg	Source image path from Asset API upload	✔️
promptObject.prompt	string	gentle waves moving	Text description of desired motion/scene	✔️
promptObject.taskType	string	img2video-concat	Generation mode (concat or replace)	✔️
promptObject.aspectRatio	string	16:9	Video aspect ratio	✔️

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_TO_VIDEO",
"model": "Qubico/hunyuan",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
  "imageUrl": "images/2025_10_22_07_10_43_846_elon-musk.jpg",
  "prompt": "A person walking through a peaceful garden with gentle movement",
  "taskType": "img2video-concat",
  "aspectRatio": "16:9"
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_TO_VIDEO',
  model: 'Qubico/hunyuan',
  conversationId: 'IMAGE_TO_VIDEO',
  promptObject: {
    imageUrl: 'images/2025_10_22_07_10_43_846_elon-musk.jpg',
    prompt: 'A person walking through a peaceful garden with gentle movement',
    taskType: 'img2video-concat',
    aspectRatio: '16:9'
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_TO_VIDEO",
"model": "Qubico/hunyuan",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
  "imageUrl": "images/2025_10_22_07_10_43_846_elon-musk.jpg",
  "prompt": "A person walking through a peaceful garden with gentle movement",
  "taskType": "img2video-concat",
  "aspectRatio": "16:9"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Hunyuan AI

Source Image *

Path to the source image file uploaded via Asset API

Motion Description *

Describe the motion and animation you want to see in the video

A person walking through a peaceful garden with gentle movement

Generation Mode *

Choose generation mode - Concatenation for better movement, Replacement for image adherence

Concatenation - Focus on natural movementReplacement - Maintain image details

Aspect Ratio *

Choose the aspect ratio for your video output

16:9 (Landscape)9:16 (Portrait)1:1 (Square)

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_TO_VIDEO",
  "model": "Qubico/hunyuan",
  "conversationId": "IMAGE_TO_VIDEO",
  "promptObject": {
    "imageUrl": "images/2025_10_22_07_10_43_846_elon-musk.jpg",
    "prompt": "A person walking through a peaceful garden with gentle movement",
    "taskType": "img2video-concat",
    "aspectRatio": "16:9"
  }
}'

Response

{}