Novita AI의 Hunyuan Image 3 API: 텍스트-이미지 생성 가이드

Novita AI의 Hunyuan Image 3 API: 텍스트-이미지 생성 가이드

Tencent의 Hunyuan Image 3가 이제 Novita AI에서 https://api.novita.ai/v3/async/hunyuan-image-3 엔드포인트를 통해 비동기 텍스트-이미지 API로 제공됩니다. 이 모델은 800억 개의 파라미터를 가진 mixture-of-experts 아키텍처(현재까지 가장 큰 오픈소스 이미지 생성 MoE)를 사용하며, 강력한 다국어 텍스트 렌더링, 세밀한 프롬프트 준수, 이미지당 $0.10의 유연한 출력 크기 조정이 필요한 개발자에게 실용적인 선택입니다. 이 가이드에서는 이 모델의 장점, 통합 방법, 그리고 프로덕션 이미지 파이프라인에서의 활용처를 다룹니다.

핵심 요약

  • Hunyuan Image 3는 Novita AI에서 POST https://api.novita.ai/v3/async/hunyuan-image-3로 제공되며, 가격은 이미지당 $0.10입니다(2026-07-06 확인).
  • 이 모델은 80B MoE 아키텍처(토큰당 13B 파라미터 활성)와 autoregressive 통합 생성 프레임워크를 사용합니다.
  • 중국어와 영어 프롬프트를 기본 지원하며, 이미지 내 텍스트 렌더링이 뛰어납니다.
  • API는 비동기 방식입니다. 요청을 제출하면 task_id를 받고, 작업 결과 API를 폴링하여 출력을 얻습니다.
  • 실용적인 활용: 복잡한 다국어 장면, 텍스트가 많은 이미지, 추론 수준의 프롬프트 해석이 필요한 파이프라인.

Hunyuan Image 3란?

Hunyuan Image 3(HunyuanImage 3.0)는 Tencent의 3세대 텍스트-이미지 모델로, 2025년 9월에 오픈소스로 공개되었습니다. 대부분의 이미지 생성 모델이 diffusion transformer(DiT) 아키텍처를 기반으로 하는 것과 달리, Hunyuan Image 3는 텍스트와 이미지 생성을 하나의 모델링 문제로 취급하는 통합 autoregressive 프레임워크 를 사용합니다. 이는 대규모 언어 모델에서 사용되는 동일한 아키텍처 접근 방식입니다.

그 결과, 모델은 이미지 콘텐츠를 생성하기 전에 추론하며, "thinking tokens"를 사용한 chain-of-thought 스키마를 통해 희소하거나 모호한 프롬프트를 해석하고, 누락된 세부 정보를 추론하며, 단순히 토큰 빈도를 일치시키는 것이 아니라 의도에 맞는 출력을 생성합니다.

주요 아키텍처 정보(출처: HunyuanImage 3.0 technical report, arXiv 2509.23951, 2025년 9월):

  • 총 800억 개 파라미터, 64개 전문가, 토큰당 약 130억 개 파라미터 활성화
  • Autoregressive 통합 멀티모달 프레임워크(DiT 기반 아님)
  • thinking tokens를 통한 Chain-of-thought 프롬프트 추론
  • 프롬프트 정렬을 위한 강화 학습 후처리
  • 중국어 및 영어 기본 지원

Hunyuan Image 2.1과 비교하여 3.0 릴리스는 이미지 품질 및 텍스트 정렬에 대한 전문 평가에서 14.1%의 상대적 승률 향상을 보여줍니다.

Novita AI의 Hunyuan Image 3 API 액세스

Novita AI는 Hunyuan Image 3를 비동기 작업 API로 호스팅합니다. 워크플로는 다음과 같습니다:

  1. https://api.novita.ai/v3/async/hunyuan-image-3로 생성 요청을 POST
  2. 응답에서 task_id 수신
  3. task_idhttps://api.novita.ai/v3/async/task-result를 폴링하여 작업 상태가 TASK_STATUS_SUCCEED가 될 때까지 대기
  4. 결과에서 이미지 URL 추출

API 키는 Novita AI 콘솔에서 받을 수 있습니다. 새 계정에는 $1의 무료 크레딧이 제공됩니다.

Hunyuan Image 3 사양 및 가격 요약

필드 세부 정보 출처 / 확인 날짜
표시 이름 Hunyuan Image 3 Novita AI 문서 / 2026-07-06
엔드포인트 /v3/async/hunyuan-image-3 Novita AI 문서 / 2026-07-06
기본 URL https://api.novita.ai Novita AI 문서 / 2026-07-06
아키텍처 80B MoE, autoregressive, 13B 활성 arXiv 2509.23951 / 2025년 9월
지원 언어 영어, 중국어 Tencent HunyuanImage-3.0 저장소 / 2025년 9월
출력 형식 JPEG(기본값) Novita AI 문서 / 2026-07-06
가격 이미지당 $0.10 novita.ai/models / 2026-07-06
API 유형 비동기(제출 + 폴링) Novita AI 문서 / 2026-07-06
최적 용도 다국어 장면, 텍스트가 많은 이미지, 복잡한 프롬프트 해석 판단

개발자를 위한 주요 기능

프롬프트 추론. chain-of-thought 메커니즘 덕분에 "고급 일본 차 브랜드의 제품 사진"과 같은 짧은 프롬프트를 받아도 긴 상세 프롬프트 없이 적절한 시각적 맥락(조명, 구성, 스타일 큐)을 추가하여 이미지를 생성할 수 있습니다. 이는 프롬프트가 프롬프트 엔지니어가 아닌 최종 사용자로부터 오는 파이프라인에서 유용합니다.

텍스트 렌더링. Hunyuan Image 3는 중국어와 영어 모두에서 대부분의 오픈소스 T2I 모델보다 훨씬 뛰어난 이미지 내 텍스트 처리를 제공합니다. 사용 사례에 읽을 수 있는 간판, 라벨, UI 목업 또는 지역화된 콘텐츠가 포함된 이미지 생성이 필요한 경우, 텍스트를 위해 별도의 후처리 단계가 필요하지 않은 몇 안 되는 모델 중 하나입니다.

유연한 크기 조정. API는 width*height 형식의 size 매개변수를 지원하여 웹, 소셜 및 인쇄 출력을 위한 다양한 종횡비를 포괄합니다.

이중 언어 파이프라인. 중국어 프롬프트는 로마자 변환 아티팩트나 번역 오버헤드 없이 중국어에 적합한 콘텐츠를 생성합니다. 중국어 사용자를 대상으로 하는 앱에 유용합니다.

Hunyuan Image 3를 사용해야 하는 경우

  • 프롬프트가 짧거나 사용자가 제공하며 생성 전에 지능적인 정교화가 필요한 경우
  • 이미지 내에 읽을 수 있는 중국어 또는 영어 텍스트가 필요한 경우
  • 지역화된 마케팅 자산, 제품 이미지 또는 편집용 비주얼을 생성하는 경우
  • 일관된 구성을 위해 여러 의미 요소가 있는 복잡한 장면을 설명하는 프롬프트가 있는 경우

Hunyuan Image 3를 사용하지 말아야 하는 경우

  • 이미지당 최저 비용이 필요한 경우: 이미지당 $0.10의 가격에서 Novita AI의 Qwen Image(이미지당 $0.02) 또는 Seedream 3.0(이미지당 $0.03)과 같은 대안이 텍스트 렌더링과 추론이 중요하지 않은 대용량 파이프라인에서 훨씬 저렴합니다.
  • 이미지 편집 또는 인페인팅이 필요한 경우: Hunyuan Image 3는 텍스트-이미지만 지원합니다. 이미지 편집 워크플로에는 전용 편집 모델을 사용하세요.
  • 서브초 응답 시간이 필요한 경우: 비동기 아키텍처는 폴링으로 인해 지연 시간이 추가됩니다. 실시간 대화형 애플리케이션에는 적합하지 않습니다.

API 빠른 시작

Python

import requests
import time

API_KEY = "YOUR_NOVITA_API_KEY"
BASE_URL = "https://api.novita.ai"

def generate_image(prompt: str, size: str = "1024*1024", seed: int = -1) -> str:
    # Submit generation request
    response = requests.post(
        f"{BASE_URL}/v3/async/hunyuan-image-3",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json={
            "prompt": prompt,
            "size": size,
            "seed": seed,
        },
    )
    response.raise_for_status()
    task_id = response.json()["task_id"]

    # Poll for result
    while True:
        result = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers={"Authorization": f"Bearer {API_KEY}"},
            params={"task_id": task_id},
        )
        result.raise_for_status()
        data = result.json()
        status = data.get("task", {}).get("status")
        if status == "TASK_STATUS_SUCCEED":
            return data["images"][0]["image_url"]
        elif status == "TASK_STATUS_FAILED":
            raise RuntimeError(f"Generation failed: {data}")
        time.sleep(2)

image_url = generate_image(
    prompt="A minimalist product photo of a premium Japanese matcha tin on a white marble surface, studio lighting",
    size="1024*1024",
)
print(image_url)

cURL

# Step 1: Submit request
curl -s -X POST https://api.novita.ai/v3/async/hunyuan-image-3 \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A neon-lit street food stall in Hong Kong at night, cinematic, rainy reflections",
    "size": "1280*720",
    "seed": -1
  }'

# Returns: {"task_id": "..."}

# Step 2: Poll for result
curl -s "https://api.novita.ai/v3/async/task-result?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

요청 매개변수

매개변수 유형 필수 참고
prompt string 이미지에 대한 텍스트 설명. 영어 및 중국어 지원.
size string 아니오 width*height 형식의 출력 크기(예: "1024*1024", "1280*720", "768*1024")
seed integer 아니오 -1은 무작위; 고정값을 설정하여 결과 재현 가능

작업 결과 상태 값

상태 의미
TASK_STATUS_QUEUED 요청 수신됨, 실행 대기 중
TASK_STATUS_RUNNING 생성 진행 중
TASK_STATUS_SUCCEED 완료 — images[0].image_url에서 이미지 URL 확인 가능
TASK_STATUS_FAILED 생성 실패

API 워크플로에 Hunyuan Image 3 통합하기

Novita AI에서 Hunyuan Image 3가 사용하는 비동기 패턴은 플랫폼의 다른 이미지 및 비디오 생성 엔드포인트와 동일합니다. 작업을 제출하고 task_id를 받은 후 결과를 폴링합니다. 이미 Novita AI의 FLUX.1 Dev 또는 Kontext 제품군을 사용하고 있다면, 엔드포인트 한 줄만 변경하고 요청 본문을 업데이트하면 Hunyuan Image 3로 전환할 수 있습니다.

한 가지 실질적인 차이점: Hunyuan Image 3는 중첩된 input/parameters 객체 대신 평평한 요청 본문(prompt, size, seed)을 사용합니다. 통합하기 전에 Novita AI 문서에서 표준 스키마를 확인하세요.

최종 권장 사항

Hunyuan Image 3는 프롬프트 추론, 다국어 텍스트 렌더링 또는 복잡한 장면 구성이 비용보다 중요할 때 Novita AI에서 적합한 선택입니다. 이미지당 $0.10의 가격은 Novita AI 이미지 카탈로그 중 높은 편에 속합니다(Seedream 3.0의 약 3배, Qwen Image의 약 5배). 하지만 이는 의미 있게 다른 기능을 제공합니다. 희소한 프롬프트를 해석하고, 이미지 내에서 읽을 수 있는 중국어와 영어 텍스트를 생성하며, 간단한 모델이 일관되지 않은 구성을 생성하는 경향이 있는 의미적으로 밀집된 장면을 처리합니다.

대용량 일반 이미지 생성에는 더 저렴한 대안이 더 나은 시작점입니다. 이미지 품질, 텍스트 정확성 또는 이중 언어 콘텐츠가 요구되는 프로덕션 워크플로의 경우, Hunyuan Image 3는 가격 차이를 충분히 상쇄할 가치가 있습니다.

FAQ

Novita AI의 Hunyuan Image 3 엔드포인트는 무엇인가요?

POST https://api.novita.ai/v3/async/hunyuan-image-3입니다. API는 비동기 방식입니다. 요청을 제출하고 task_id를 받은 후 /v3/async/task-result를 폴링하여 상태가 TASK_STATUS_SUCCEED가 될 때까지 대기합니다.

Novita AI에서 Hunyuan Image 3의 비용은 얼마인가요?

2026-07-06 기준 이미지당 $0.10입니다(출처: novita.ai/models). 프로덕션 워크로드의 비용 모델을 구축하기 전에 Novita AI 가격 페이지에서 현재 가격을 확인하세요.

Hunyuan Image 3가 FLUX.1 또는 Stable Diffusion과 다른 점은 무엇인가요?

Hunyuan Image 3는 FLUX.1 및 대부분의 Stable Diffusion 변형이 사용하는 diffusion transformer(DiT) 아키텍처 대신 autoregressive 통합 멀티모달 프레임워크를 사용합니다. 실제 효과는 chain-of-thought thinking tokens를 통한 더 강력한 프롬프트 추론, 더 나은 다국어 텍스트 렌더링, 복잡한 다중 요소 장면의 더 일관된 처리입니다.

Hunyuan Image 3는 이미지 편집 또는 인페인팅을 지원하나요?

아니요. Novita AI의 이 모델은 텍스트-이미지만 지원합니다. 이미지 편집에는 FLUX.1 Kontext 또는 Qwen-Image-Edit과 같은 전용 편집 모델을 사용하세요.

Hunyuan Image 3에 중국어 프롬프트를 사용할 수 있나요?

네. 이 모델은 중국어와 영어 프롬프트를 기본 지원합니다. 중국어 프롬프트는 번역 아티팩트 없이 중국어에 적합한 시각적 콘텐츠를 생성합니다.

특정 이미지 출력을 재현하려면 어떻게 해야 하나요?

seed 매개변수를 고정 정수 값으로 설정하세요. 동일한 seed, prompt, size 조합은 동일한 이미지를 재현합니다.

추천 문서