models

Tencent: Hy Image 3.5 Preview

Markdown · JSON

Tencent: Hy Image 3.5 Preview

HY Image 3.5 Preview объединяет генерацию изображений по тексту, создание по референсам и редактирование в несколько шагов диалога. Tencent документирует поддержку до 20 изображений-референсов, автоматический выбор размера и явное задание размеров вплоть до изображения 4096 × 4096 для детальной визуальной работы.

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

HY Image 3.5 Preview — единая модель Tencent для генерации и редактирования изображений. Она принимает письменное задание с необязательными изображениями-референсами и позволяет продолжать одну визуальную задачу в течение нескольких шагов диалога. Результатом становится изображение заданной сцены, композиции или внесённой правки. В примерах Tencent представлены изображения продуктов, рекламные постеры, визуальные концепции интерфейсов и материалов. Определите, нужен ли вам новый рисунок, композиция на основе референсов или конкретное изменение уже полученного результата.

Поставщик обозначает версию как hy-image-v3.5-preview и документирует ограничение запроса в 100K токенов. На вход передаётся хронологический диалог с текстом и изображениями, причём последнее сообщение пользователя содержит текущую инструкцию. Предыдущие сообщения дают контекст для последовательного редактирования. Это отличается от процесса HY Image 3.0 с одним запросом и его собственными ограничениями ввода. Для непрерывной работы над дизайном сохраняйте актуальное задание, роли референсов и выбранное изображение, чтобы следующая инструкция опиралась на нужное визуальное состояние.

Подготовьте изображения-референсы в формате PNG или JPEG/JPG. В документированном процессе допускается до 20 входных изображений, каждое размером не более 20 MB. Изображение можно передать как ресурс по ссылке или в закодированном виде. Если в диалоге слишком много изображений, руководство поставщика описывает удаление в первую очередь более старых. Сохраняйте набор активных референсов целенаправленным, не рассчитывая, что все исторические изображения останутся в контексте. Настройка изменения размера входных изображений сохраняет небольшие изображения и пропорционально уменьшает большие до целевого количества пикселей; по умолчанию эта цель составляет 1,048,576 пикселей. Сохраняйте достаточно видимых деталей продукта, материала или макета, которые должны направлять результат.

Подготовить размер результата можно двумя разными способами. При автоматическом выборе generate_max_pixels задаёт целевую площадь: 1,048,576 пикселей для уровня 1K, 2,359,296 для стандартного уровня 1.5K или 4,194,304 для 2K. В FAQ поставщика указано, что при передаче только целевой площади по умолчанию используется квадратное соотношение сторон. Если оба параметра размера пропущены, модель ориентируется на задание и стандартный уровень 1.5K. Эти уровни не создают автоматическую настройку 4K. Используйте уровень площади, когда задаче подходит квадратное изображение. Чтобы пропорции определялись заданием при стандартном уровне 1.5K, пропустите оба параметра размера; если макету нужен конкретный вертикальный или широкий формат, задайте размеры явно.

При явном задании размеров поставщик допускает положительные целые значения сторон от 256 до 8192 пикселей при общей площади не более 16,777,216 пикселей. Квадрат 4096 × 4096 соответствует этому ограничению. Диапазон сторон и предельная площадь действуют одновременно, поэтому сторона в 8192 пикселя не означает, что можно получить изображение 8192 × 8192. Явно задавайте требуемую ширину и высоту, если конечному макету нужен конкретный размер, а не предполагайте, что уровень целевой площади определяет те же габариты. Отразите в запросе детали, чувствительные к обрезке, и необходимое свободное пространство.

Модель поддерживает редактирование в несколько шагов через возвращаемую историю диалога. Tencent различает итоговое выдаваемое изображение и промежуточное изображение, служащее контекстом для следующей правки; при продолжении в примерах сохраняются рассуждения ассистента, запрос к инструменту и результат генерации изображения. Для композиции с продуктом сначала определите объект и кадрирование, а затем запросите изменение освещения или новый фон, указав, что должно сохранить свой вид. Храните выбранный результат вместе с его историей, чтобы следующий шаг работал с этим изображением, а не с отброшенным вариантом. В документированном процессе Tencent ссылки как на итоговое изображение, так и на изображение в истории истекают через 12 часов, поэтому сохраняйте сами файлы, прежде чем рассчитывать на них при последующей правке.

Среди документированных настроек есть seed, собственная подпись водяного знака длиной до 16 символов и необязательное дополнение внешним поиском, по умолчанию отключённое. Seed — неотрицательное целое число; нулевое значение или отсутствие параметра позволяет поставщику выбрать его случайно. Эти настройки выполняют задачи, отличные от самого визуального задания. Для изображения продукта по референсу опишите внешний вид продукта, ракурс камеры, поверхность, освещение и предполагаемый макет, а затем используйте референс для передачи узнаваемых деталей. Для постера задайте иерархию и точную формулировку вместо того, чтобы оставлять сообщение на усмотрение модели.

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

Ailoot Ultra · Картинки POST /v1/images/generations tencent/hy-image-v3.5-preview

tencent/hy-image-v3.5-preview

Tencent /tencent/hy-image-v3.5-preview

Начало

HY Image 3.5 Preview объединяет генерацию изображений по тексту, создание по референсам и редактирование в несколько шагов диалога. Tencent документирует поддержку до 20 изображений-референсов, автоматический выбор размера и явное задание размеров вплоть до изображения 4096 × 4096 для детальной визуальной работы.

Допустимые входные данные
Текст · Картинки
Результаты
Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Картинки POST /v1/images/generations
Входные данные
text, image
Результат
image
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
tencent/hy-image-v3.5-preview
По умолчанию—
ПолеpromptТипstringТребованиеОбязательноЗначения и ограничения
Минимальная длина: 1
По умолчанию—
ПолеresolutionТипstringТребованиеНеобязательноЗначения и ограничения
1K, 1.5K, 2K, 4K
По умолчанию—
Полеaspect_ratioТипstringТребованиеНеобязательноЗначения и ограничения
1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9
По умолчанию—
ПолеnТипintegerТребованиеНеобязательноЗначения и ограничения
Минимум: 1
Максимум: 1
По умолчанию—
Полеinput_referencesТипarrayТребованиеНеобязательноЗначения и ограничения
Минимум элементов: 0
Максимум элементов: 20
По умолчанию—
ПолеproviderТипobjectТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, prompt
Параметрmaterial_typesКонтрактtext, image

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим
Не указано При выборе быстрого режима
Режим flex
Не указано При выборе режима flex
Максимальная интенсивность рассуждений
Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

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

КонфигурацияШкала ставокПрогноз количестваРасчётная единицаПлата
КонфигурацияБазовые тарифы на токеныШкала ставокБазовая ставкаПрогноз количества—Расчётная единица—Плата
Вход · Входные токены · Оценка только для сравнения — / 1K токенов
Выход · Выходные токены · Оценка только для сравнения — / 1K токенов
Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов
Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
Конфигурациятокен выходного изображенияШкала ставок—Прогноз количества—Расчётная единица/ 1K токенов изображенияПлата
Выход · токен выходного изображения · Оценка только для сравнения $0.0032 / 1K токенов изображения
КонфигурацияОриентировочная стоимость генерацииШкала ставок—Прогноз количестваОценка для одной генерацииРасчётная единица—Плата
Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.0131072 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Картинки

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'tencent/hy-image-v3.5-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Картинки

Загрузите каждое полученное изображение или сохраните его содержимое Base64

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Чтение другого содержимого
Читать существующие материалы, принадлежащие вам
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

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

Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа
ПолеТип
ПолеcreatedТип
Полеdata[].urlТип
Полеdata[].b64_jsonТип
ПолеusageТип

Псевдонимы

Псевдонимы моделей

Ailoot Ultra tencent/hy-image-v3.5-preview

Псевдонимы путей метода

/v1/images

Связанные ID для вызова

tencent/hy-image-v3.5-preview

FAQ · Tencent: Hy Image 3.5 Preview
Какие входные данные и результаты доступны?

POST /v1/images/generations · tencent/hy-image-v3.5-preview: text, image → image

Какие поля использует запрос?

POST /v1/images/generations · tencent/hy-image-v3.5-preview: model, prompt, resolution, aspect_ratio, n, input_references, provider

Какие ограничения действуют?

POST /v1/images/generations · tencent/hy-image-v3.5-preview: n.minimum: 1; n.maximum: 1

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

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

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

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

Запросить реселлерскую лицензию · Оферта и лицензионный договор