API Hunyuan Image 3 на Novita AI: руководство по генерации изображений из текста

API Hunyuan Image 3 на Novita AI: руководство по генерации изображений из текста

Hunyuan Image 3 от Tencent теперь доступен на Novita AI как асинхронное API для генерации изображений из текста по адресу https://api.novita.ai/v3/async/hunyuan-image-3. Модель использует архитектуру смеси экспертов с 80 миллиардами параметров — крупнейшую открытую MoE для генерации изображений на сегодняшний день — и является практичным выбором для разработчиков, которым нужен качественный многоязычный рендеринг текста, точное следование промптам и гибкие размеры вывода по цене $0.10 за изображение. Это руководство охватывает сильные стороны модели, способы интеграции и её место в производственном конвейере изображений.

Ключевые выводы

  • Hunyuan Image 3 доступен на Novita AI по адресу POST https://api.novita.ai/v3/async/hunyuan-image-3 по цене $0.10/изображение (проверено 06.07.2026).
  • Модель использует архитектуру 80B MoE (13B параметров активны на токен) с авторегрессионным унифицированным фреймворком генерации.
  • Встроенная поддержка китайских и английских промптов с качественным рендерингом текста внутри изображения.
  • API асинхронный: вы отправляете запрос, получаете task_id, затем опрашиваете Task Result API для получения результата.
  • Практическое применение: сложные многоязычные сцены, изображения с большим количеством текста, конвейеры, требующие интерпретации промптов на уровне рассуждений.

Что такое Hunyuan Image 3?

Hunyuan Image 3 (HunyuanImage 3.0) — это модель третьего поколения Tencent для генерации изображений из текста, опубликованная с открытым исходным кодом в сентябре 2025 года. В отличие от большинства моделей генерации изображений, построенных на архитектурах диффузионных трансформеров (DiT), Hunyuan Image 3 использует унифицированный авторегрессионный фреймворк, который рассматривает генерацию текста и изображения как единую задачу моделирования — тот же архитектурный подход, что и в больших языковых моделях.

Результат — модель, которая обдумывает содержание изображения перед его генерацией, используя схему цепочки рассуждений с «токенами мышления» для интерпретации коротких или неоднозначных промптов, вывода недостающих деталей и создания результатов, соответствующих намерению, а не просто частоте токенов.

Ключевые факты архитектуры (источник: HunyuanImage 3.0 technical report, arXiv 2509.23951, сентябрь 2025):

  • 80B параметров, 64 эксперта, ~13B параметров активируются на токен
  • Авторегрессионный унифицированный мультимодальный фреймворк (не на основе DiT)
  • Рассуждение по цепочке мыслей через токены мышления
  • Дообучение с подкреплением для улучшения соответствия промптам
  • Встроенная поддержка китайского и английского языков

По сравнению с Hunyuan Image 2.1, версия 3.0 показывает улучшение на 14,1% относительно выигрыша в профессиональной человеческой оценке качества изображения и соответствия тексту.

Доступ к API Hunyuan Image 3 на Novita AI

Novita AI предоставляет Hunyuan Image 3 как асинхронное API задач. Процесс:

  1. POST запрос на генерацию к https://api.novita.ai/v3/async/hunyuan-image-3
  2. Получить task_id в ответе
  3. Опрашивать https://api.novita.ai/v3/async/task-result с task_id, пока статус задачи не станет TASK_STATUS_SUCCEED
  4. Извлечь URL изображения из результата

Получите ключ API в консоли Novita AI. Новые аккаунты получают $1 бесплатных кредитов.

Спецификации и цены Hunyuan Image 3

Поле Детали Источник / Дата проверки
Отображаемое имя Hunyuan Image 3 Документация Novita AI / 06.07.2026
Эндпоинт /v3/async/hunyuan-image-3 Документация Novita AI / 06.07.2026
Базовый URL https://api.novita.ai Документация Novita AI / 06.07.2026
Архитектура 80B MoE, авторегрессионная, 13B активных arXiv 2509.23951 / Сентябрь 2025
Поддерживаемые языки Английский, китайский Репозиторий Tencent HunyuanImage-3.0 / Сентябрь 2025
Формат вывода JPEG (по умолчанию) Документация Novita AI / 06.07.2026
Цена $0.10 за изображение novita.ai/models / 06.07.2026
Тип API Асинхронный (отправка + опрос) Документация Novita AI / 06.07.2026
Наилучшее применение Многоязычные сцены, изображения с текстом, сложная интерпретация промптов Оценка

Ключевые возможности для разработчиков

Рассуждение по промпту. Механизм цепочки рассуждений позволяет модели взять короткий промпт, например «фотография продукта для премиального японского чайного бренда», и дополнить его подходящим визуальным контекстом — освещение, композиция, стилевые подсказки — без необходимости длинного детального промпта. Это полезно для конвейеров, где промпты поступают от конечных пользователей, а не от инженеров промптов.

Рендеринг текста. Hunyuan Image 3 обрабатывает текст внутри изображения как на китайском, так и на английском значительно лучше, чем большинство моделей T2I с открытым исходным кодом. Если ваш сценарий включает генерацию изображений с читаемыми вывесками, этикетками, макетами интерфейсов или локализованным контентом, это одна из немногих моделей, где не требуется отдельный этап постобработки текста.

Гибкие размеры. API принимает параметр size в формате width*height, охватывающий широкий диапазон соотношений сторон для веб, социальных сетей и печати.

Двуязычные конвейеры. Промпты на китайском языке генерируют контент, соответствующий китайскому контексту, без артефактов романизации или дополнительных затрат на перевод. Полезно для приложений, ориентированных на китайскоязычную аудиторию.

Когда использовать Hunyuan Image 3

  • Ваши промпты короткие или предоставлены пользователем и нуждаются в интеллектуальном дополнении перед генерацией
  • Вам нужен читаемый текст на китайском или английском языке внутри изображения
  • Вы создаете локализованные маркетинговые материалы, изображения продуктов или редакционные визуалы
  • Ваш промпт описывает сложные сцены с несколькими семантическими элементами, требующими когерентной композиции

Когда не следует использовать Hunyuan Image 3

  • Вам нужна минимальная стоимость за изображение: по цене $0.10/изображение альтернативы, такие как Qwen Image на Novita AI ($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 Завершено — URL изображения доступен в images[0].image_url
TASK_STATUS_FAILED Генерация не удалась

Как Hunyuan Image 3 вписывается в ваш рабочий процесс API

Асинхронный шаблон, используемый Hunyuan Image 3 на Novita AI, аналогичен другим эндпоинтам генерации изображений и видео на платформе — отправка задачи, получение task_id, опрос результатов. Если вы уже используете FLUX.1 Dev на Novita AI или семейство Kontext, переход на Hunyuan Image 3 — это изменение одной строки эндпоинта и обновление тела запроса.

Одно практическое отличие: Hunyuan Image 3 принимает плоское тело запроса (prompt, size, seed), а не вложенные объекты input/parameters. Перед интеграцией проверьте каноническую схему в документации Novita AI.

Итоговая рекомендация

Hunyuan Image 3 — правильный выбор на Novita AI, когда рассуждение по промпту, многоязычный рендеринг текста или сложная композиция сцены важнее, чем стоимость. При цене $0.10 за изображение он находится в верхней части каталога изображений Novita AI — примерно в 3 раза дороже Seedream 3.0 и в 5 раз дороже Qwen Image — но предлагает качественно другую возможность: модель интерпретирует короткие промпты, генерирует читаемый текст на китайском и английском языках в изображениях и обрабатывает семантически насыщенные сцены, где более простые модели обычно дают несвязные композиции.

Для высокообъемной типовой генерации изображений более дешевые альтернативы являются лучшей отправной точкой. Для производственных рабочих процессов, где качество изображения, точность текста или двуязычный контент являются требованиями, Hunyuan Image 3 стоит разницы в цене.

Часто задаваемые вопросы

Какой эндпоинт 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.

Сколько стоит Hunyuan Image 3 на Novita AI?

$0.10 за изображение по состоянию на 06.07.2026 (источник: novita.ai/models). Перед построением модели стоимости для производственных нагрузок проверьте актуальные цены на странице цен Novita AI.

Что отличает Hunyuan Image 3 от FLUX.1 или Stable Diffusion?

Hunyuan Image 3 использует авторегрессионный унифицированный мультимодальный фреймворк, а не архитектуру диффузионного трансформера (DiT), используемую в FLUX.1 и большинстве вариантов Stable Diffusion. Практический эффект — более сильное рассуждение по промпту за счет токенов мышления с цепочкой рассуждений, лучший многоязычный рендеринг текста и более связная обработка сложных сцен с несколькими элементами.

Поддерживает ли Hunyuan Image 3 редактирование изображений или инпейнтинг?

Нет. Модель на Novita AI работает только с текстом в изображение. Для редактирования изображений используйте выделенную модель, такую как FLUX.1 Kontext или Qwen-Image-Edit.

Можно ли использовать китайские промпты с Hunyuan Image 3?

Да. Модель изначально поддерживает китайские и английские промпты. Китайские промпты генерируют визуальный контент, соответствующий китайскому контексту, без артефактов перевода.

Как воспроизвести конкретный вывод изображения?

Установите параметр seed в фиксированное целое число. Одна и та же комбинация seed, prompt и size воспроизведет то же изображение.

Рекомендованные статьи