APIMaster.ai

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.