Bytedance HuMo: Human-Centric Video Generation

HuMo generates high-quality, human-centric videos from text, images, and audio with unparalleled control and precision.

~0.00s
~$5
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/bytedance-humo"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "frames": 30,
12    "scale_a": 5,
13    "scale_t": 5,
14    "mode": "TA",
15    "height": 720,
16    "width": 1280,
17    "steps": 30
18}
19
20response = requests.post(url, headers=headers, json=data)
21
22if response.status_code == 200:
23    result = response.json()
24    print(json.dumps(result, indent=2))
25else:
26    print(f"Error: {response.status_code}")
27    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/bytedance-humo

Parameters

framesoptional
integer

Number of frames for the generated video

Default: 30Range: 10 - 100
heightoptional
integer

Video height (e.g., 720 or 480).

Default: 720
Allowed values :
720480
modeoptional
string

Input mode: TA for text+audio; TIA for text+image+audio.

Default: "TA"
Allowed values :
"TA""TIA"
scale_aoptional
number

Strength of audio guidance. Higher = better audio-motion sync

Default: 5Range: 1 - 10
scale_toptional
number

Strength of text guidance. Higher = better adherence to text prompts

Default: 5Range: 1 - 10
stepsoptional
integer
Default: 30Range: 1 - 100
widthoptional
integer

Video width (e.g., 1280 or 832).

Default: 1280
Allowed values :
1280832

Response Type

Returns: Video

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out