Model icon
hunyuan-3d/v3.1/pro/text-to-3d
Text to 3D
Image to 3D
모델:
Hunyuan 3D v3.1 API는 게임, 제품 시각화, 프로토타이핑, 3D 에셋 파이프라인을 위한 Pro/Rapid text-to-3D 및 image-to-3D를 지원합니다.
입력
36/1024
출력

예시 출력

이는 샘플 데이터입니다. 새 결과를 생성하면 실제 출력을 확인할 수 있습니다.

작업 ID:hunyuan-3d-31-pro-text-example생성 시간:2026-06-24T08:00:00.000Z
상태:finished진행률:100%
Examples
가격 세부정보

숨겨진 비용 없이 투명한 가격입니다. 사용한 만큼만 지불하세요.

Hunyuanhunyuan-3d/v3.1/pro/text-to-3d
Base generation
PoYo 가격
$0.300/생성
60 크레딧
공식 가격
$0.375/생성
Official
절약률
20%
Hunyuanhunyuan-3d/v3.1/pro/image-to-3d
Base generation
PoYo 가격
$0.300/생성
60 크레딧
공식 가격
$0.375/생성
Official
절약률
20%
Hunyuanhunyuan-3d/v3.1/rapid/text-to-3d
Base generation
PoYo 가격
$0.180/생성
36 크레딧
공식 가격
$0.225/생성
Official
절약률
20%
Hunyuanhunyuan-3d/v3.1/rapid/image-to-3d
Base generation
PoYo 가격
$0.180/생성
36 크레딧
공식 가격
$0.225/생성
Official
절약률
20%
Hunyuanhunyuan-3d/v3.1/pro/image-to-3d
PBR add-on
PoYo 가격
$0.120
24 크레딧
공식 가격
$0.150
Official
절약률
20%
Hunyuanhunyuan-3d/v3.1/pro/image-to-3d
Multi-view add-on
PoYo 가격
$0.120
24 크레딧
공식 가격
$0.150
Official
절약률
20%
Hunyuanhunyuan-3d/v3.1/pro/text-to-3d
Custom face count add-on
PoYo 가격
$0.120
24 크레딧
공식 가격
$0.150
Official
절약률
20%

* 실제 비용은 최종 출력을 기준으로 합니다.

소개

Hunyuan 3D v3.1 API 사용에 대한 전체 가이드

Hunyuan 3D v3.1 API

PoYo.ai는 네 가지 Hunyuan 3D v3.1 모델을 제공하며 작업 제출, 상태 조회, 콜백, 3D 파일 다운로드를 같은 방식으로 처리합니다.

사용 가능한 모델

01

hunyuan-3d/v3.1/pro/image-to-3d

전면 객체 이미지를 PBR, 지오메트리, 면 수, 추가 뷰 옵션이 있는 3D 에셋으로 변환합니다.
API 키 받기
02

hunyuan-3d/v3.1/pro/text-to-3d

더 긴 프롬프트에서 Pro 옵션으로 3D 에셋을 생성합니다.
API 키 받기
03

hunyuan-3d/v3.1/rapid/text-to-3d

짧은 프롬프트로 빠른 3D 초안을 생성합니다.
API 키 받기
04

hunyuan-3d/v3.1/rapid/image-to-3d

단일 객체 이미지에서 빠르게 3D 모델을 만듭니다.
API 키 받기

Hunyuan 3D v3.1 API 주요 기능

PoYo에서 공개된 제어 항목으로 Pro 또는 Rapid text-to-3D/image-to-3D 모델을 선택하세요.

01

Pro image-to-3D와 다중 뷰 참조

객체의 전면 이미지를 업로드하고 필요하면 측면, 후면, 상단, 하단 또는 비스듬한 뷰를 추가할 수 있습니다. Pro image-to-3D는 PBR, 지오메트리 모드, 사용자 지정 면 수도 지원합니다.

  • 전면 이미지는 PoYo image_urls로 제출
  • Pro image-to-3D에서 선택 다중 뷰 필드 지원
  • 필요 시 PBR 및 면 수 제어 사용
Hunyuan 3D v3.1 Pro image to 3D generated asset preview

02

상세 프롬프트용 Pro text-to-3D

객체의 형태, 재질 방향, 에셋 컨셉을 텍스트로 자세히 지정해야 할 때 Pro text-to-3D를 사용합니다. PoYo는 상태 조회와 콜백에 동일한 비동기 API 흐름을 사용합니다.

  • 더 긴 프롬프트 지원
  • PBR, 지오메트리 모드, 면 수 선택 가능
  • 상태와 파일 조회 방식 통일
Hunyuan 3D v3.1 Pro text to 3D generated asset preview

03

빠른 초안을 위한 Rapid text-to-3D

Rapid text-to-3D는 초기 아이디어, 객체 탐색, 낮은 비용의 3D 초안 생성에 적합합니다. 짧은 프롬프트로 여러 방향을 빠르게 비교할 수 있습니다.

  • Pro보다 낮은 기본 비용
  • 지오메트리 모드가 아닐 때 PBR 사용 가능
  • 에셋 탐색과 반복에 적합
Hunyuan 3D v3.1 Rapid text to 3D generated asset preview

04

단일 참조 이미지용 Rapid image-to-3D

제품, 소품, 스케치 또는 객체 참조 이미지가 이미 있을 때 Rapid image-to-3D로 빠르게 3D 결과를 얻을 수 있습니다.

  • 이미지 한 장을 입력으로 사용
  • 지원 범위에서 PBR 또는 지오메트리 옵션 사용
  • 썸네일과 모델 파일 반환
Hunyuan 3D v3.1 Rapid image to 3D generated asset preview

사용 사례

01

게임 소품 아이디어

수작업 모델링 전에 프롬프트나 객체 참조로 초기 소품 컨셉을 생성합니다.

02

제품 및 객체 시각화

전면 이미지나 다중 뷰 참조를 검토 및 다운로드 가능한 3D 출력으로 변환합니다.

03

3D 에셋 탐색

동일한 API 형식에서 Pro와 Rapid 결과, 상태, 파일 조회를 비교합니다.

04

비동기 3D 파이프라인

콜백 또는 폴링으로 Hunyuan 3D 작업을 제출하고 완료된 모델 파일을 제작 도구에 연결합니다.

Hunyuan 3D v3.1 Pro vs Rapid

PoYo에서 제공하는 네 가지 Hunyuan 3D v3.1 모델 비교입니다.

기능ProRapid
입력 모델Text-to-3D 및 image-to-3DText-to-3D 및 image-to-3D
적합한 작업PBR, 지오메트리, 면 수 또는 다중 뷰가 필요한 고제어 작업프롬프트 또는 한 장의 이미지에서 빠른 저비용 초안
프롬프트 길이최대 1024자최대 200자
이미지 제어전면 이미지와 Pro image의 추가 뷰 URL단일 전면 이미지
가격 방식기본 생성에 선택 추가 기능기본 생성에 선택 PBR 추가 기능

정확한 출력은 선택한 모델과 반환 파일에 따라 달라집니다.

PoYo에서 Hunyuan 3D v3.1 API 사용하기

1단계: API 키 만들기
PoYo에 가입하고 대시보드에서 API 키를 생성합니다.
API 키 만들기 ->

2단계: Hunyuan 3D v3.1 모델 선택
Pro image, Pro text, Rapid text, Rapid image 중 하나를 선택합니다.

3단계: PoYo 입력 제출
텍스트 모델은 prompt, 이미지 모델은 image_urls를 사용합니다. PBR, 지오메트리, 면 수, 다중 뷰 필드는 선택한 모델이 지원할 때만 추가합니다.

4단계: 생성 에셋 가져오기
작업 상태를 조회하거나 callback URL을 제공한 뒤 GLB, OBJ, MTL, 텍스처, 썸네일 또는 모델 URL 파일을 다운로드합니다.
문서 보기 ->

Hunyuan 3D v3.1 API 가격

PoYo의 Hunyuan 3D v3.1은 생성 단위로 과금되며 선택 기능에 따라 추가 비용이 발생합니다.

Pro 모델과 Rapid 모델은 서로 다른 기본 가격을 사용합니다. PBR, 다중 뷰 입력, 사용자 지정 면 수는 지원 모델에서 활성화할 때 추가로 계산됩니다.

크레딧을 충전하고 PoYo에서 Hunyuan 3D v3.1을 테스트하세요. 크레딧 충전 ->

FAQ

어떤 Hunyuan 3D v3.1 모델을 선택해야 하나요?

PBR, 지오메트리 모드, 사용자 지정 면 수 또는 다중 뷰 이미지가 필요하면 Pro를 사용하고, 낮은 비용의 빠른 초안에는 Rapid를 사용하세요.

PoYo에서 이미지 입력은 어떻게 사용하나요?

이미지 모델은 image_urls에 전면 이미지 URL 하나를 넣습니다. Hunyuan 3D 이미지 모델 간 입력 형식은 동일합니다.

다중 뷰 이미지를 사용할 수 있나요?

네, hunyuan-3d/v3.1/pro/image-to-3d에서만 가능합니다. 선택 필드는 후면, 왼쪽, 오른쪽, 위, 아래, 왼쪽 앞, 오른쪽 앞 이미지 URL입니다.

API는 어떤 파일을 반환하나요?

모델에 따라 GLB, OBJ, MTL, 텍스처, 썸네일, 모델 URL 모음이 포함될 수 있습니다.

PoYo.ai를 사용하는 이유

01

하나의 비동기 3D API

네 가지 Hunyuan 3D v3.1 모델이 같은 제출, 상태, 콜백, 파일 조회 방식을 사용합니다.

02

투명한 크레딧 가격

제출 전에 기본 생성과 선택 기능의 예상 크레딧을 확인할 수 있습니다.

03

모델별 제어 항목

Playground는 선택한 Pro 또는 Rapid 모델이 지원하는 제어 항목만 표시합니다.

04

정규화된 출력 파일

PoYo는 모델, 텍스처, 썸네일을 일관된 작업 결과 형식으로 정리합니다.