Source: https://ailoot.ai/models/ru/tencent-hy-image-v3-5-preview/ Canonical: https://ailoot.ai/models/ru/tencent-hy-image-v3-5-preview/ Language: ru # Tencent: Hy Image 3.5 Preview [Markdown](https://ailoot.ai/models/ru/tencent-hy-image-v3-5-preview/index.md) · [JSON](https://ailoot.ai/models/ru/tencent-hy-image-v3-5-preview/facts.json) ## [Tencent: Hy Image 3.5 Preview](https://ailoot.ai/models/ru/tencent-hy-image-v3-5-preview/) HY Image 3.5 Preview объединяет генерацию изображений по тексту, создание по референсам и редактирование в несколько шагов диалога. Tencent документирует поддержку до 20 изображений-референсов, автоматический выбор размера и явное задание размеров вплоть до изображения 4096 × 4096 для детальной визуальной работы. - [**Ailoot Ultra · Картинки** `POST /v1/images/generations` `tencent/hy-image-v3.5-preview`](https://ailoot.ai/models/ru/tencent-hy-image-v3-5-preview/#method-0) О модели Описание раскрывает возможности модели. Доступные в 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`](https://ailoot.ai/models/ru/#m=tencent%2Fhy-image-v3.5-preview&route=Ultra&caller=tencent%2Fhy-image-v3.5-preview&fmt=images) 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 резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. [Как работают резервирование и расчёт →](https://ailoot.ai/docs/ru/billing/reserve/) ### Примеры запросов #### Ailoot Ultra · Картинки curl ```bash 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"