Hy Image 3.5 Preview · Referencia de la API y facturación
Genera imágenes a partir de texto o referencias y edítalas en varios turnos.
Envía una solicitud JSON con autenticación Bearer y una clave API de APIMaster válida.
POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json
Parámetros de la solicitud
| Campo | Tipo | Descripción |
|---|---|---|
model |
string |
hy-image-v3.5-preview (obligatorio). |
messages |
object[] |
Mensajes en orden cronológico. El último mensaje user contiene la instrucción actual y los anteriores aportan el contexto de edición. Obligatorio. |
size |
string |
Dimensiones en formato ancho x alto sin espacios, como 4096x4096. Cada lado admite 256–8192 píxeles y el área máxima es de 16,777,216 píxeles. |
seed |
int64 |
Entero entre 0 y 2⁶³−1. Con 0 o sin este valor, la semilla es aleatoria. |
generate_max_pixels |
integer |
Se aplica sin size. Valores: 1,048,576, 2,359,296 (predeterminado) y 4,194,304. Se usa el nivel más cercano. Para 4K usa size. |
resize_max_pixels |
integer |
Reduce proporcionalmente las imágenes de referencia que superen esta área. Valor predeterminado: 1,048,576 píxeles. |
session |
string |
Mantén el mismo valor durante la edición para facilitar la reutilización de la ruta y la caché KV. |
footnote |
string |
Marca de agua en la esquina inferior derecha, de hasta 16 caracteres Unicode. |
use_search_tool |
object |
Usa {"value":true} o {"value":false}. La búsqueda está desactivada de forma predeterminada. |
Cada mensaje incluye role (user, assistant o tool) y una matriz content. Usa type=text con text, o type=image_url con image_url:{url:...}. Se aceptan URL públicas o URI de datos con prefijo MIME. El límite es de 20 MB por imagen, 20 imágenes por contexto y 100,000 tokens de contexto. Devuelve el tool_call_id correspondiente y marca las imágenes ya generadas con is_generate:true.
Un mensaje assistant puede reenviar reasoning y tool_calls tal como se recibieron. Si solo llama a una herramienta, puede omitir content. La llamada usa {id,type:"function",function:{name,arguments}}, con una cadena JSON en arguments.
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":"Un círculo azul sobre fondo blanco"}]}]}'
Respuesta
La respuesta puede contener tramas JSON consecutivas. Consulta el Content-Type. La imagen final está en choices[0].delta.image.url y sus dimensiones en width y height. Un finish_reason nulo puede indicar una respuesta válida si existe la URL. Descárgala antes de que caduque. Usa assembled_history para seguir editando. Conserva el request_id ante errores o desconexiones. Repetir la generación puede generar otro cargo.
Facturación
La pasarela reserva saldo y liquida una vez según tokenhub_usage.total_tokens. Consulta la ficha para ver el precio actual de APIMaster.
