APIMaster.ai

Hy Image 3.5 Preview · Riferimento API e fatturazione

Genera immagini da testo o riferimenti e modificale in più passaggi.

Invia una richiesta JSON con autenticazione Bearer e una chiave API APIMaster valida.

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

Parametri della richiesta

Campo Tipo Descrizione
model string hy-image-v3.5-preview (obbligatorio).
messages object[] Messaggi in ordine cronologico. L'ultimo messaggio user contiene l'istruzione corrente. I precedenti forniscono il contesto di modifica. Obbligatorio.
size string Dimensioni nel formato larghezzaxaltezza, ad esempio 4096x4096. Ogni lato misura da 256 a 8192 pixel e l'area massima è di 16,777,216 pixel.
seed int64 Intero da 0 a 2⁶³−1. Usa 0 oppure ometti il campo per un seed casuale.
generate_max_pixels integer Vale se size è assente. Valori: 1,048,576, 2,359,296 (predefinito) e 4,194,304. Viene scelto il livello più vicino. Per il 4K usa size.
resize_max_pixels integer Le immagini di riferimento oltre questa area vengono ridotte proporzionalmente. Valore predefinito: 1,048,576 pixel.
session string Mantieni lo stesso valore nella sessione di modifica per agevolare il riuso del routing e della cache KV.
footnote string Filigrana personalizzata in basso a destra, fino a 16 caratteri Unicode.
use_search_tool object Usa {"value":true} o {"value":false}. La ricerca è disattivata per impostazione predefinita.

Ogni messaggio contiene role (user, assistant o tool) e un array content. Usa type=text con text o type=image_url con image_url:{url:...}. Sono ammessi URL pubblici e URI di dati con prefisso MIME. Limiti: 20 MB per immagine, 20 immagini e 100,000 token per contesto. Per i risultati degli strumenti, restituisci il tool_call_id corrispondente e indica is_generate:true per le immagini già generate.

Un messaggio assistant può inoltrare reasoning e tool_calls così come ricevuti. Se chiama solo uno strumento, può omettere content. Il formato è {id,type:"function",function:{name,arguments}}, con una stringa JSON in 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 cerchio blu su sfondo bianco"}]}]}'

Risposta

La risposta può contenere più frame JSON consecutivi. Segui il Content-Type effettivo. L'URL finale è in choices[0].delta.image.url, con dimensioni in width e height. Anche una risposta riuscita può avere finish_reason nullo. Verifica l'URL e scarica l'immagine prima della scadenza. Per continuare la modifica, usa assembled_history. Conserva il request_id in caso di errori o interruzioni. Ripetere la generazione può comportare un altro addebito.

Fatturazione

Il gateway riserva credito e addebita una sola volta in base a tokenhub_usage.total_tokens. Il prezzo APIMaster aggiornato è nella scheda del modello.