Hunyuan AI - Text to Video

Generate high-quality videos from text descriptions using Tencent's Hunyuan AI model. Offers both standard and fast generation modes with multiple aspect ratio options.

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	TEXT_TO_VIDEO	Feature identifier	✔️
model	string	Qubico/hunyuan	AI model to use	✔️
conversationId	string	TEXT_TO_VIDEO	Conversation context	✔️
promptObject.prompt	string	a peaceful garden	Video description	✔️
promptObject.aspectRatio	string	16:9	Video aspect ratio (16:9, 9:16, 1:1)	✔️
promptObject.taskType	string	txt2video	Generation mode (txt2video, fast-txt2video, or txt2video-lora)	✔️
promptObject.loraType	string	anime	LoRA type (required when taskType is txt2video-lora)	❌

Generation Modes

• txt2video - Standard quality generation
• fast-txt2video - Faster generation with optimized processing
• txt2video-lora - LoRA-enhanced generation (currently supports anime style)

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "TEXT_TO_VIDEO",
"model": "Qubico/hunyuan",
"conversationId": "TEXT_TO_VIDEO",
"promptObject": {
  "prompt": "a peaceful zen garden with falling cherry blossoms",
  "aspectRatio": "16:9",
  "taskType": "txt2video",
}
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'TEXT_TO_VIDEO',
  model: 'Qubico/hunyuan',
  conversationId: 'TEXT_TO_VIDEO',
  promptObject: {
    prompt: 'a peaceful zen garden with falling cherry blossoms',
    aspectRatio: '16:9',
    taskType: 'txt2video',
  }
})
})

Python

import requests

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

data = {
"type": "TEXT_TO_VIDEO",
"model": "Qubico/hunyuan",
"conversationId": "TEXT_TO_VIDEO",
"promptObject": {
  "prompt": "a peaceful zen garden with falling cherry blossoms",
  "aspectRatio": "16:9",
  "taskType": "txt2video",
}
}

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

Interactive Playground

API Playground

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

AI Model *Hunyuan AI

Video Description *a peaceful zen garden with falling cherry blossoms

Aspect Ratio *16:9 (Landscape)9:16 (Portrait)1:1 (Square)

Generation Mode *StandardFastLoRA

LoRA Type Anime

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": "TEXT_TO_VIDEO",
  "model": "Qubico/hunyuan",
  "conversationId": "TEXT_TO_VIDEO",
  "promptObject": {
    "prompt": "a peaceful zen garden with falling cherry blossoms",
    "aspectRatio": "16:9",
    "taskType": "txt2video"
  }
}'

Response

{
"aiRecord": {
  "uuid": "55113799-3b16-4951-b5ee-186a6ce238cf",
  "userId": "2f57c2a4-1fff-48e7-972f-3c1d6c59bced",
  "teamId": "eb48d89f-1bb7-4d82-9b25-481971a0e97a",
  "teamUser": {
    "teamId": "eb48d89f-1bb7-4d82-9b25-481971a0e97a",
    "userId": "2f57c2a4-1fff-48e7-972f-3c1d6c59bced",
    "userName": "John",
    "userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 16762338,
    "createdAt": "2025-11-25T11:04:08.620Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-11-26T08:57:54.836Z",
    "updatedBy": "SYSTEM"
  },
  "model": "Qubico/hunyuan",
  "type": "TEXT_TO_VIDEO",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-11-26T09:02:06.650Z",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "a peaceful zen garden with falling cherry blossoms",
      "taskType": "txt2video",
      "aspectRatio": "16:9"
    },
    "resultObject": [
      "development/videos/2025_11_26_16_06_36_293_586348.mp4"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/videos/2025_11_26_16_06_36_293_586348.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251126%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251126T090643Z&X-Amz-Expires=604800&X-Amz-Signature=8faaaac1a5c7c082d8c9cc4e0ed4b7a37ae26f1222ec73402f5250117e937b77&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}