Skip to main content

Hunyuan AI - Image to Video

Create dynamic videos from static images using Hunyuan AI's specialized image-to-video generation models with different processing modes.

Model Information​

  • Model ID: Qubico/hunyuan
  • Display Name: Hunyuan AI
  • Provider: Qubico/Hunyuan AI

API Usage​

API Playground

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

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": {
    "image": "<base64-encoded-image-or-url>",
    "prompt": "A person walking through a peaceful garden",
    "taskType": "img2video-concat",
    "aspectRatio": "16:9"
  }
}'

Parameters​

Required Parameters​

  • image (string): The source image for video generation. Can be a base64-encoded image or image URL
  • prompt (string): Text description of what you want to see in the generated video
  • taskType (string): Generation mode - either concatenation or replacement
  • aspectRatio (string): Video aspect ratio

Parameter Details​

taskType​

  • Type: String
  • Required: Yes
  • Values:
    • "img2video-concat": Generate videos based on images for better movement
    • "img2video-replace": Generate videos following the guiding image better
  • Default: "img2video-concat"
  • Description: Choose the generation mode based on your needs. Concatenation mode focuses on natural movement, while replacement mode maintains closer adherence to the source image.

aspectRatio​

  • Type: String
  • Required: Yes
  • Values: "16:9", "9:16", "1:1"
  • Default: "16:9"
  • Description: Output video aspect ratio

prompt​

  • Type: String
  • Required: Yes
  • Description: Detailed description of the desired video content and movement

Response Format​

{}

Example Request​

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": {
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD...",
      "prompt": "A serene lake with gentle ripples and soft sunlight reflecting on the water surface",
      "taskType": "img2video-concat",
      "aspectRatio": "16:9"
    }
  }'

Generation Modes​

Concatenation Mode (img2video-concat)​

  • Purpose: Generates videos based on images with focus on natural movement
  • Best for: Creating dynamic scenes where movement is the primary focus
  • Characteristics: Produces more fluid motion and natural transitions

Replacement Mode (img2video-replace)​

  • Purpose: Generates videos that closely follow the guiding image
  • Best for: Maintaining visual consistency with the source image while adding subtle motion
  • Characteristics: Preserves more details from the original image while adding controlled movement

Features​

  • Two specialized generation modes for different use cases
  • Multiple aspect ratios for various content formats
  • High-quality video generation with good movement dynamics
  • Suitable for both creative and professional video projects