Hunyuan3D API
Tencent Hunyuan3D — 시각화와 콘텐츠 워크플로를 위한 이미지-투-3D, 텍스트-투-3D, 스케치-투-3D 생성입니다. V2 Base, Mini, Multi-View 변형과 V3 이미지-투-3D, 텍스트-투-3D, 스케치-투-3D 엔드포인트를 제공합니다.
V2: 단일 이미지 3D를 위한 v2-base와 v2-mini, 여러 이미지로 재구성하는 v2-multi-view, 확장 가능한 에셋 제작을 위한 v2.1. V3: image-to-3d(사진에서 초고해상도), text-to-3d(프롬프트에서 완전히 텍스처링된 모델), sketch-to-3d(콘셉트 아트에서 메시).
개요
Hunyuan3D API 소개
Hunyuan3D의 기능, Tencent 모델 라인업에서의 위치, 그리고 팀들이 이 모델을 선택하는 이유.
Tencent의 3D 에셋 생성 모델 Hunyuan3D. WaveSpeedAI REST API로 바로 사용할 수 있습니다. Tencent Hunyuan3D — 시각화와 콘텐츠 워크플로를 위한 이미지-투-3D, 텍스트-투-3D, 스케치-투-3D 생성입니다. V2 Base, Mini, Multi-View 변형과 V3 이미지-투-3D, 텍스트-투-3D, 스케치-투-3D 엔드포인트를 제공합니다.
V2: 단일 이미지 3D를 위한 v2-base와 v2-mini, 여러 이미지로 재구성하는 v2-multi-view, 확장 가능한 에셋 제작을 위한 v2.1. V3: image-to-3d(사진에서 초고해상도), text-to-3d(프롬프트에서 완전히 텍스처링된 모델), sketch-to-3d(콘셉트 아트에서 메시).
WaveSpeedAI의 Hunyuan3D 제품군은 Image-To-3d, Text-To-3d 워크플로를 아우르는 REST 엔드포인트 7개를 제공합니다. 각 변형은 고유한 가격, 파라미터, 예시 출력을 갖고 있으니 입력 방식과 운영 조건에 맞는 것을 고르거나, 같은 API 키로 여러 개를 호출해 다단계 파이프라인을 구성하세요.
Hunyuan3D 실행에도 WaveSpeedAI의 다른 1,000개 이상의 AI 모델과 같은 API 키, 결제 계정, 요청 한도 체계를 그대로 사용합니다. 별도의 벤더 설정도, 제공사별 SDK도, 벤더별 요청 한도 체계도 필요 없습니다. 하나의 연동으로 텍스트 → 이미지, 텍스트 → 비디오부터 오디오 합성, 3D 생성, 업스케일링, 편집까지 모두 지원합니다.
엔드포인트
Hunyuan3D API 전체 엔드포인트
Hunyuan3D 엔드포인트 7개를 지금 WaveSpeedAI에서 사용할 수 있습니다. 워크플로에 맞는 변형을 고르세요.
/filters:quality(82)/media/images/1789124787640423161_ZFOX7hqy.webp)
Hunyuan3d v3 Sketch To 3d
Transform your sketches into detailed 3D models with Tencent's Hunyuan3D V3. Convert hand-drawn sketches and concept art into high-quality 3D assets with textures, perfect for rapid prototyping and game development. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1789121202949516194_iYoyHQZ9.webp)
Hunyuan3d v3 Image To 3d
Transform your photos into ultra-high-resolution 3D models in seconds with Tencent's Hunyuan3D V3 Image to 3D. Film-quality geometry with PBR textures from single or multi-view images, ready for games, e-commerce, and 3D printing. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1789116903089615525_rhenxGPZ.webp)
Hunyuan3d v3 Text To 3d
Turn text prompts into detailed, fully-textured 3D models with Tencent's Hunyuan3D V3. Generate high-quality 3D assets with PBR materials from simple descriptions, ready for Unity, Unreal, and Blender. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1789124963421423807_NtCLU3dn.webp)
Hunyuan3d v2.1
Tencent Hunyuan3D v2.1 is a scalable 3D asset-creation system that advances state-of-the-art 3D generation for asset workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408111455_pe9fgusa.webp)
Hunyuan3d v2 Multi View
Hunyuan3D V2 Multi-View generates accurate 3D reconstructions from multiple images. Tencent-developed and available on WaveSpeedAI. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408111453_hu9t8kxy.webp)
Hunyuan3d v2 Mini
Hunyuan3D-V2-Mini is a Tencent image-to-3D generative model available on WaveSpeedAI. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408111447_w87sl0cm.webp)
Hunyuan3d v2 Base
Hunyuan3D-V2-Base is a state-of-the-art Image-to-3D model by Tencent that turns images into 3D assets for visualization and content. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
예시
Hunyuan3D 활용 예시
Hunyuan3D API로 생성한 실제 출력물입니다. 비디오 위에 마우스를 올리면 미리 보고, 클릭하면 전체 크기 뷰어가 열립니다.
사용 방법
Hunyuan3D API 사용 방법
가입부터 결과물 생성까지 네 단계입니다. Python, Node.js, cURL 전체 예시는 아래 API 섹션에 있습니다.
- 01
API 키 받기
WaveSpeedAI 계정을 만들고 대시보드에서 API 키를 복사하세요. 신규 계정에는 무료 스타터 크레딧이 제공되어, 요금이 청구되기 전에 Playground를 수십 번 실행해 볼 수 있습니다.
- 02
Prediction 제출
입력을 JSON으로 https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base에 POST하세요. 엔드포인트가 prediction id를 즉시 반환합니다. 생성은 비동기로 처리되므로 추론 중에 연결을 계속 열어 둘 필요가 없습니다.
- 03
완료될 때까지 폴링
https://api.wavespeed.ai/api/v3/predictions/{request_id}/result로 GET 요청을 보내세요. completed이면 outputs를 반환하고, failed, cancelled, timeout, deleted이면 오류로 종료하며, 그 밖의 모든 status에서는 폴링을 계속합니다.
- 04
출력 URL 읽기
status가 "completed"가 되면 data.outputs[0]에서 URL을 읽으세요. 이 URL은 WaveSpeedAI CDN에 있는 생성된 미디어를 가리키며, 호출한 Hunyuan3D 변형에 따라 이미지, 비디오, 오디오 또는 3D 파일입니다.
활용 사례
Hunyuan3D 활용 사례
개발자와 크리에이터가 Hunyuan3D API를 사용하는 대표적인 워크플로입니다.
단일 이미지에서 3D 에셋으로
wavespeed-ai/hunyuan3d/v2-base는 Tencent의 최첨단 이미지-투-3D 모델로, 이미지를 시각화와 콘텐츠를 위한 3D 에셋으로 변환합니다. 제품과 캐릭터 메시 생성을 위한 기본 엔드포인트입니다.
경량 Mini 변형
wavespeed-ai/hunyuan3d/v2-mini는 Tencent의 소형 이미지-투-3D 생성 모델입니다. 빠른 반복 작업, 모바일 미리보기, 메시 디테일을 후속 단계에서 다듬어도 되는 파이프라인에 유용합니다.
멀티 뷰 재구성
wavespeed-ai/hunyuan3d/v2-multi-view는 여러 이미지에서 정확한 3D 재구성을 생성합니다. 정면, 측면, 후면 뷰를 제공하면 가려진 면의 지오메트리가 더 탄탄해집니다.
v2.1 확장 가능한 에셋 제작
wavespeed-ai/hunyuan3d/v2.1은 최첨단 3D 생성을 발전시킨 Tencent의 확장 가능한 3D 에셋 제작 시스템입니다. 더 높은 충실도가 필요한 프로덕션 에셋 워크플로를 위한 변형입니다.
프롬프트로 만드는 V3 텍스트-투-3D
wavespeed-ai/hunyuan3d-v3/text-to-3d는 텍스트 프롬프트를 정교하고 완전히 텍스처링된 3D 모델로 만듭니다. 소스 이미지 없이 설명만으로 에셋을 생성하세요.
콘셉트 아트를 위한 V3 스케치-투-3D
wavespeed-ai/hunyuan3d-v3/sketch-to-3d는 손으로 그린 스케치와 콘셉트 아트를 정교한 3D 모델로 변환합니다. 초기 단계의 디자인 탐색에 유용합니다.
팁
Hunyuan3D 프롬프트 작성 팁
Hunyuan3D에서 더 나은 결과를 얻기 위한 실용적인 조언입니다. 운영 파이프라인에서 3D 모델 전반에 통하는 패턴을 바탕으로 했습니다.
- 01
가려진 지오메트리에는 멀티 뷰
정면, 측면, 후면 사진이 있다면 v2-multi-view를 사용하세요. 단일 이미지 Base/Mini는 가려진 면을 추측하지만, 멀티 뷰는 이를 정확하게 재구성합니다.
- 02
빠른 반복에는 Mini
콘셉트를 탐색하는 동안 빠른 미리보기 메시에는 v2-mini를 사용하고, 지오메트리 방향이 확정되면 v2-base 또는 v2.1로 전환하세요.
- 03
깨끗하고 조명이 좋은 소스 이미지
이미지-투-3D의 품질은 소스 사진의 품질에 좌우됩니다. 고른 조명, 최소한의 그림자, 분명한 피사체 실루엣이 더 깨끗한 메시를 만듭니다.
- 04
PBR은 후속 단계에서 계획하세요
Hunyuan3D는 시각화를 위한 메시를 출력합니다. 생성 후 DCC 도구나 렌더링 엔진에서 텍스처링과 PBR 재질 작업을 계획하세요.
- 05
중립적인 배경의 제품 사진
흰색/중립적인 배경의 이커머스 제품 사진이 가장 깨끗한 지오메트리 추출을 만듭니다. 복잡한 배경은 재구성된 메시에 노이즈를 더합니다.
가격
Hunyuan3D API 가격
가격은 출력당 책정됩니다. 최종 요금은 각 변형의 Playground에서 설정한 파라미터(해상도, 길이, 출력 수, 레퍼런스)에 따라 달라집니다.
| 엔드포인트 | 유형 | 시작 가격 |
|---|---|---|
| wavespeed-ai/ | image-to-3d | $0.45 |
| wavespeed-ai/ | image-to-3d | $0.30 |
| wavespeed-ai/ | text-to-3d | $0.30 |
| wavespeed-ai/ | image-to-3d | $0.45 |
| wavespeed-ai/ | image-to-3d | $0.20 |
| wavespeed-ai/ | image-to-3d | $0.12 |
| wavespeed-ai/ | image-to-3d | $0.16 |
API
Hunyuan3D API 호출하기
wavespeed.ai/accesskey에서 API 키를 발급받은 뒤 REST로 prediction을 제출하세요. Playground에서 입력 조합별로 바로 붙여넣을 수 있는 샘플이 생성됩니다.
POSThttps://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)비교
Hunyuan3D vs 대안
비슷한 WaveSpeedAI 모델과 비교한 Hunyuan3D의 선택 기준.
Hunyuan3D vs Tripo3D
Tripo3D는 텍스처 베이킹을 지원하는 빠른 이미지-투-3D를 제공합니다. Hunyuan3D는 Tencent의 연구 스택에서 나온 여러 품질 등급(Base, Mini, Multi-View, v2.1)을 제공하므로 입력 유형(단일 vs 멀티 뷰)과 필요한 충실도에 따라 선택하세요.
Hunyuan3D vs Meshy
Meshy는 웹 우선의 3D 생성 도구입니다. Hunyuan3D는 WaveSpeedAI에서 API 우선으로 제공되어, 수동 UI 단계 없이 자동화된 파이프라인, 배치 에셋 생성, SaaS 연동에 더 알맞습니다.
Hunyuan3D vs Manual photogrammetry
사진측량은 수십 장의 사진과 긴 처리 시간이 필요합니다. Hunyuan3D는 한 장 또는 몇 장의 이미지로 쓸 만한 메시를 몇 초 만에 생성하므로, 프로토타이핑에는 더 빠르고 스캔 수준의 재구성에는 덜 정확합니다.
FAQ
Hunyuan3D API — 자주 묻는 질문
가격, 라이선스, 연동 — WaveSpeedAI에서 Hunyuan3D 실행에 관한 자주 묻는 질문.
Hunyuan3D API란 무엇인가요?
Hunyuan3D — WaveSpeedAI에서 REST API로 제공되는 Tencent의 3D 모델입니다. Tencent Hunyuan3D — 시각화와 콘텐츠 워크플로를 위한 이미지-투-3D, 텍스트-투-3D, 스케치-투-3D 생성입니다. V2 Base, Mini, Multi-View 변형과 V3 이미지-투-3D, 텍스트-투-3D, 스케치-투-3D 엔드포인트를 제공합니다. 프로그래밍 방식으로 호출하거나 위에 링크된 Playground에서 체험해 볼 수 있습니다.
Hunyuan3D API는 어떻게 호출하나요?
WaveSpeedAI 계정을 만들고 /accesskey에서 API 키를 복사한 뒤, 입력을 JSON으로 https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan3d/v2-base에 POST하세요. 엔드포인트가 prediction id를 반환합니다. 결과 엔드포인트 폴링은 약 2초마다 시작하고, 오래 걸리는 작업은 간격을 늘리며, 종료 status가 나오면 중단하세요. 운영 환경용 Python / Node.js / cURL 예시는 위에 있습니다.
Hunyuan3D API 요금은 얼마인가요?
Hunyuan3D의 가격은 회당 $0.12부터입니다. 정확한 비용은 설정한 파라미터(해상도, 길이, 출력 수, 레퍼런스)에 따라 달라집니다. Playground의 생성 버튼 옆 실시간 비용 미리보기에서 현재 입력 기준의 정확한 가격을 확인할 수 있습니다.
Hunyuan3D에는 어떤 변형이 있나요?
WaveSpeedAI에는 라이브 Hunyuan3D 엔드포인트가 7개 있습니다: wavespeed-ai/hunyuan3d-v3/sketch-to-3d, wavespeed-ai/hunyuan3d-v3/image-to-3d, wavespeed-ai/hunyuan3d-v3/text-to-3d, wavespeed-ai/hunyuan3d/v2.1, wavespeed-ai/hunyuan3d/v2-multi-view, wavespeed-ai/hunyuan3d/v2-mini, wavespeed-ai/hunyuan3d/v2-base. 각 변형에는 고유한 Playground 페이지와 가격이 있습니다.
Hunyuan3D 출력물을 상업적으로 사용할 수 있나요?
상업적 사용 권한은 Tencent 모델 라이선스를 따릅니다. 대부분의 Tencent 모델은 출력물의 상업적 사용을 허용합니다. 구체적인 라이선스 요약은 각 모델의 Playground 페이지를, 플랫폼 수준의 조건은 WaveSpeedAI 이용약관을 참고하세요.
직접 연동하지 않고 WaveSpeedAI에서 Hunyuan3D 모델을 사용하는 이유는 무엇인가요?
API 키 하나와 결제 계정 하나로 Hunyuan3D 모델과 다른 제공사의 1,000개 이상의 AI 모델을 모두 사용합니다. 벤더별 SDK 설정도, 별도의 요청 한도 체계도, 벤더마다 연동 코드를 다시 쓸 일도 없습니다. 가격은 대체로 Tencent의 직접 API와 같거나 더 저렴합니다.
제공사
Tencent 소개
WaveSpeedAI의 Hunyuan3D 및 Tencent 전체 모델 라인업을 만든 팀.
Tencent의 Hunyuan 팀은 사진을 시각화, 게임 에셋, 이커머스를 위한 3D 메시로 변환하는 이미지-투-3D 모델 패밀리인 Hunyuan3D를 만듭니다. 변형은 단일 이미지 생성, 경량 Mini 추론, 멀티 뷰 재구성, 확장 가능한 에셋 제작 시스템인 v2.1을 다룹니다.
WaveSpeedAI에서 Hunyuan3D 시작하기
가입 시 무료 스타터 크레딧 제공. Tencent 및 다른 모든 제공사의 1,000개 이상 AI 모델을 API 키 하나로.