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Начало
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 · Картинки
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}/contentGET /v1/media/assetsGET /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 для вызова
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