APIMaster.ai

Hy Image 3.5 Preview · Справочник API и тарификация

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

Отправьте JSON-запрос с Bearer-аутентификацией и действующим ключом API APIMaster.

POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json

Параметры запроса

Поле Тип Описание
model string hy-image-v3.5-preview (обязательно).
messages object[] Сообщения в хронологическом порядке. Последнее сообщение user содержит текущую инструкцию. Предыдущие сообщения задают контекст редактирования. Обязательно.
size string Размер в формате ширинаxвысота, например 4096x4096. Допустимо 256–8192 пикселей на сторону и не более 16,777,216 пикселей по площади.
seed int64 Целое число от 0 до 2⁶³−1. Значение 0 или отсутствие поля даёт случайное начальное значение.
generate_max_pixels integer Действует без size. Варианты: 1,048,576, 2,359,296 (по умолчанию) и 4,194,304. Промежуточные значения округляются до ближайшего уровня. Для 4K используйте size.
resize_max_pixels integer Более крупные референсы пропорционально уменьшаются. Значение по умолчанию: 1,048,576 пикселей.
session string Сохраняйте значение в пределах сеанса редактирования для повторного использования маршрута и KV-кэша.
footnote string Водяной знак в правом нижнем углу, до 16 символов Unicode.
use_search_tool object Укажите {"value":true} или {"value":false}. Поиск по умолчанию отключён.

Сообщение содержит role (user, assistant или tool) и массив content. Для текста используйте type=text и text, для изображения — type=image_url и image_url:{url:...}. Поддерживаются публичные URL и URI данных с префиксом MIME. Пределы: 20 МБ на изображение, 20 изображений и 100,000 токенов на контекст. Для результатов инструментов передавайте соответствующий tool_call_id, а ранее созданные изображения помечайте is_generate:true.

Сообщение assistant может вернуть reasoning и tool_calls без изменений. Если оно только вызывает инструмент, поле content можно опустить. Формат вызова: {id,type:"function",function:{name,arguments}}, где arguments — строка JSON.

curl -X POST "https://apimaster.ai/v1/wand/hunyuan-image/v35-generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hy-image-v3.5-preview","size":"1024x1024","messages":[{"role":"user","content":[{"type":"text","text":"Синий круг на белом фоне"}]}]}'

Ответ

Ответ может содержать последовательные кадры JSON. Учитывайте фактический Content-Type. Итоговый URL находится в choices[0].delta.image.url, размеры — в width и height. При успехе finish_reason может иметь значение null. Проверьте URL и скачайте изображение до истечения срока действия. Для следующего шага используйте assembled_history. При сбое сохраните request_id. Повторная генерация может тарифицироваться отдельно.

Тарификация

Шлюз резервирует средства и выполняет один расчёт по tokenhub_usage.total_tokens. Актуальная цена APIMaster указана в карточке модели.