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.
