이미지

HY Image 3.5 Preview API

HY Image 3.5 Preview API로 텐센트 훈위안(Tencent Hunyuan)의 최신 이미지 모델을 사용하세요. 텍스트 이미지 생성, 참조 이미지 편집, 다중 이미지 합성을 한 모델에서 처리하며, 다국어 텍스트 렌더링이 뛰어나고 1K·2K·4K 또는 정확한 픽셀 크기로 출력합니다.

텍스트 이미지 생성이미지 편집참조 최대 5장1K / 2K / 4K텍스트 렌더링

API 키 발급 API 문서

서비스 하이라이트

공식 할인
종량제
고속 & 저지연

Input

모델

참조 이미지

프롬프트

화면 비율

해상도

부정적 프롬프트

시드

출력

Image link valid for 72 hours

HY Image 3.5 Preview API 요금

숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.

모델	등급	골드 가격현재 가격	플래티넘 가격	다이아몬드 가격	공식 가격	절약률
`hy-image-v3.5-preview`	1K	0.192Credits(~$0.0192)/장	0.1824Credits(~$0.0182)/장	0.1728Credits(~$0.0173)/장	0.24Credits(~$0.024)/장	20%
	2K	0.192Credits(~$0.0192)/장	0.1824Credits(~$0.0182)/장	0.1728Credits(~$0.0173)/장	0.24Credits(~$0.024)/장	20%
	4K	0.256Credits(~$0.0256)/장	0.2432Credits(~$0.0243)/장	0.2304Credits(~$0.023)/장	0.32Credits(~$0.032)/장	20%

* 실제 비용은 최종 출력에 따라 달라집니다.

HY Image 3.5 Preview API로 이미지 생성 및 편집

텐센트 훈위안의 HY Image 3.5 Preview는 텍스트로 이미지를 만들고, 사진을 편집하고, 최대 5장의 참조 이미지를 하나의 모델로 합성합니다. APIMart에서 모델 ID hy-image-v3.5-preview로 HY Image 3.5 Preview API를 호출해 중국어·영어 문구가 또렷한 포스터, 제품 장면, 인물이 유지되는 연속 편집을 만들어 보세요.

HY Image 3.5 Preview API 주요 기능

HY Image 3.5 Preview API에서 사용할 수 있는 생성·편집·출력 설정

하나의 HY Image API로 생성과 편집

HY Image 3.5 Preview는 모델 ID hy-image-v3.5-preview 하나로 텍스트 이미지 생성, 참조 기반 생성, 이미지 편집을 처리해 한 번의 연동으로 제작과 수정을 모두 해결합니다.

HY Image 3.5 Preview 다국어 텍스트 렌더링

Tencent HY Image 3.5는 중국어, 영어 등 여러 언어의 헤드라인, 라벨, 캡션을 깔끔하게 배치해 포스터, 인포그래픽, UI 목업에 적합합니다.

HY Image 3.5 Preview API 참조 이미지 최대 5장

hy-image-v3.5-preview 요청 하나에 최대 5장의 참조 이미지를 넣어 사진을 편집하거나, 제품을 새 장면에 배치하거나, 인물·스타일·배경을 합성할 수 있습니다.

HY Image 3.5 Preview 모델의 일관된 주체

배경, 의상, 스타일을 바꿔도 HY Image 3.5 Preview 모델은 참조 이미지 속 인물이나 제품의 핵심 특징을 유지합니다.

HY Image 3.5 Preview API 해상도 등급

어떤 화면 비율에서도 1K, 2K, 4K를 고를 수 있으며 hy-image-v3.5-preview의 기본값은 1K입니다. 픽셀을 직접 지정하면 출력 이미지의 짧은 변으로 등급이 정해집니다.

hy-image-v3.5-preview 픽셀 크기 지정

자동 또는 1:1부터 21:9까지 10가지 비율을 고르거나, 가로·세로를 각각 256–8192px, 총 8,294,400픽셀 이하로 직접 지정할 수 있습니다.

HY Image 3.5 Preview 네거티브 프롬프트와 시드

negative_prompt로 원치 않는 요소를 제외하고, seed를 고정하면 같은 구도를 재현할 수 있습니다. seed를 비우거나 0으로 두면 무작위로 생성됩니다.

HY Image 3.5 Preview API 요청당 이미지 1장

HY Image API 요청은 비동기 작업으로 이미지 1장을 반환합니다. 잘못된 파라미터는 400 오류로 거부되어 과금되지 않으며, 실패한 작업은 전액 환불됩니다.

HY Image 3.5 Preview API 활용 사례

마케팅·제품·디자인 팀이 HY Image 3.5 Preview 모델로 만드는 것

HY Image 3.5 Preview로 만드는 중영 이중 언어 포스터

중국어와 영어 헤드라인이 또렷한 캠페인 포스터, 배너, SNS 이미지를 생성하세요. 게시 전에 문구를 꼭 검수하세요.

HY Image 3.5 Preview API로 만드는 이커머스 제품 사진

참조 사진 속 제품을 라이프스타일이나 스튜디오 장면에 배치해 상세 페이지, 광고, 썸네일에 활용합니다.

Tencent HY Image 3.5로 만드는 인포그래픽과 UI 목업

텍스트, 아이콘, 구조가 명확히 읽혀야 하는 인포그래픽, 앱 화면, 슬라이드 비주얼의 초안을 만듭니다.

HY Image 3.5 Preview로 하는 패션·캐릭터 편집

의상, 배경, 화풍을 바꾸면서 여러 장의 이미지에서 같은 얼굴이나 캐릭터를 유지합니다.

HY Image 3.5 Preview API로 그리는 일러스트와 콘셉트 아트

기획 초기에 시네마틱, 코믹, 일러스트, 상업 사진 등 다양한 스타일을 하나의 모델로 시험해 보세요.

hy-image-v3.5-preview로 하는 다중 이미지 합성

인물, 제품, 배경 등 최대 5장의 참조 이미지를 프롬프트에 설명한 하나의 자연스러운 장면으로 합칩니다.

HY Image 3.5 Preview API 키 발급과 시작 방법

가입부터 첫 HY Image 3.5 Preview API 요청까지 세 단계

APIMart 계정 만들기

무료로 가입하세요. 하나의 APIMart 계정으로 HY Image API를 통해 HY Image 3.5 Preview와 플랫폼의 모든 모델을 사용할 수 있습니다.

→

크레딧 충전

잔액을 충전하세요. 크레딧은 모든 모델에서 공유되며 HY Image 3.5 Preview는 출력 이미지 장당 과금됩니다.

→

API 키로 hy-image-v3.5-preview 호출하기

대시보드에서 API 키를 발급한 뒤 모델 hy-image-v3.5-preview로 POST /v1/images/generations를 호출하세요.

API 키 받기

HY Image 3.5 Preview API 자주 묻는 질문

HY Image 3.5 Preview API의 모델, 입력, 크기, 가격, API 키, 결과 확인

HY Image 3.5 Preview API란 무엇인가요?

HY Image 3.5 Preview API는 텐센트 훈위안의 이미지 생성·편집 모델인 HY Image 3.5 Preview를 호출하는 API입니다. 이 모델은 2026년 9월 22일 호스팅형 프리뷰로 공개되었으며 텍스트 이미지 생성, 참조 기반 생성, 편집을 하나의 모델에서 지원합니다. APIMart에서는 모델 ID hy-image-v3.5-preview를 사용합니다.

HY Image 3.5 Preview는 HunyuanImage 3.0과 무엇이 다른가요?

HunyuanImage 3.0은 텐센트가 이전에 공개한 오픈 웨이트 모델입니다. HY Image 3.5 Preview는 웨이트를 공개하지 않은 호스팅형 모델이며, 텐센트는 텍스트 렌더링, 사실감, 편집 일관성을 개선한 업그레이드로 소개합니다.

HY Image 3.5 Preview의 Preview는 무슨 뜻인가요?

텐센트가 이번 릴리스를 프리뷰로 표시했기 때문에 출력 품질, 제한 사항, 기반 모델이 바뀔 수 있습니다. 프로덕션에 쓰기 전에 주요 HY Image API 워크플로를 테스트하고 이 페이지의 업데이트를 확인하세요.

HY Image 3.5 Preview API는 참조 이미지를 몇 장까지 받나요?

image_urls에 공개 접근 가능한 JPEG, PNG, WebP 이미지 URL을 최대 5장(장당 7MB 미만 권장)까지 넣을 수 있습니다. 유지·변경·합성할 요소를 프롬프트에 설명하세요. image_urls를 생략하면 hy-image-v3.5-preview가 텍스트로 이미지를 생성합니다.

HY Image 3.5 Preview API는 어떤 크기를 지원하나요?

size는 auto(기본값) 또는 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, resolution은 1K(기본값), 2K, 4K 중에서 지정합니다. 정확한 크기가 필요하면 hy-image-v3.5-preview의 size에 2000x1104 같은 픽셀 값을 넣거나 width와 height를 함께 보내세요(변당 256–8192px, 총 8,294,400픽셀 이하).

한 번의 호출로 여러 장을 만들 수 있나요?

아니요. HY Image 3.5 Preview는 요청당 이미지 1장만 반환하므로 n은 1이어야 합니다. 여러 변형이 필요하면 요청을 병렬로 보내세요.

HY Image 3.5 Preview로 같은 이미지를 여러 번 편집할 수 있나요?

네. 이전 결과를 참조 이미지로 hy-image-v3.5-preview에 다시 넣고 새 지시를 함께 보내면 됩니다. 각 단계는 별도의 요청입니다.

HY Image 3.5 Preview API 가격은 어떻게 되나요?

HY Image 3.5 Preview는 출력 이미지 장당 과금됩니다. 화면 비율을 쓰면 resolution 등급으로, 정확한 픽셀을 쓰면 짧은 변으로 등급이 정해지며 1024px 이하는 1K, 1025–2048px는 2K, 그보다 크면 4K입니다. 실시간 가격은 이 페이지의 가격표에서 확인할 수 있고, 실패한 작업은 전액 환불됩니다.

HY Image 3.5 Preview API 키는 어떻게 받나요?

APIMart에 로그인해 크레딧을 충전한 뒤 API Keys 페이지에서 키를 만드세요. Authorization 헤더에 Bearer 토큰으로 넣으면 되고, 같은 API 키로 모든 HY Image API 요청과 APIMart의 다른 모델을 사용할 수 있습니다.

HY Image 3.5 Preview API 결과는 어떻게 받나요?

모델 hy-image-v3.5-preview로 POST /v1/images/generations에 요청하고 task_id를 저장한 뒤, GET /v1/tasks/{task_id}를 3–5초마다 최대 약 5분간 조회하세요. 상태가 completed가 되면 result.images[0].url[0]을 읽고 expires_at 전에 이미지를 내려받으세요.

HY Image 3.5 Preview는 HY Image 3.5, Hunyuan Image 3.5와 같은 모델인가요?

네, 모두 텐센트의 같은 모델을 가리킵니다. 이미지 엔드포인트의 모델 ID는 hy-image-v3.5-preview이고, 텐센트 채팅 문서에서는 Hy-Image-3.5-Preview, 벤치마크 사이트에서는 HunyuanImage 3.5 (Preview)로 표기합니다. HY-Image 3.5, Hy Image3.5, HY Image v3.5, Hunyuan Image 3.5 API 같은 표기도 같은 모델입니다. APIMart에서는 HY Image API로 hy-image-v3.5-preview를 호출하세요.

도움이 필요할 때 어떻게 문의하나요?

페이지 오른쪽 하단의 실시간 채팅, [email protected] 이메일, 또는 Discord 커뮤니티를 통해 문의하실 수 있습니다. 최대한 빠르게 답변드리겠습니다.