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 указана в карточке модели.
