Hy Image 3.5 Preview · Référence de l’API et facturation
Générez des images à partir de texte ou de références et retouchez-les en plusieurs tours.
Envoyez une requête JSON avec authentification Bearer et une clé API APIMaster valide.
POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json
Paramètres de la requête
| Champ | Type | Description |
|---|---|---|
model |
string |
hy-image-v3.5-preview (obligatoire). |
messages |
object[] |
Messages dans l’ordre chronologique. Le dernier message user contient la consigne en cours. Les messages précédents fournissent le contexte de retouche. Obligatoire. |
size |
string |
Dimensions au format largeurxhauteur, par exemple 4096x4096. Chaque côté mesure de 256 à 8192 pixels et la surface est limitée à 16,777,216 pixels. |
seed |
int64 |
Entier de 0 à 2⁶³−1. La graine est aléatoire si le champ est absent ou vaut 0. |
generate_max_pixels |
integer |
S’applique en l’absence de size. Valeurs : 1,048,576, 2,359,296 (par défaut) et 4,194,304. Le palier le plus proche s’applique. Pour la 4K, indiquez size. |
resize_max_pixels |
integer |
Les images de référence dépassant cette surface sont réduites proportionnellement. Valeur par défaut : 1,048,576 pixels. |
session |
string |
Conservez cette valeur pendant la retouche pour favoriser la réutilisation du routage et du cache KV. |
footnote |
string |
Filigrane en bas à droite, limité à 16 caractères Unicode. |
use_search_tool |
object |
Utilisez {"value":true} ou {"value":false}. La recherche est désactivée par défaut. |
Chaque message comporte role (user, assistant ou tool) et un tableau content. Utilisez type=text avec text ou type=image_url avec image_url:{url:...}. Les URL publiques et les URI de données préfixés par un type MIME sont acceptés. Limites : 20 Mo par image, 20 images et 100,000 tokens par contexte. Renvoyez le tool_call_id correspondant pour les résultats d’outil et indiquez is_generate:true pour les images déjà générées.
Un message assistant peut renvoyer reasoning et tool_calls tels quels. Si le message appelle uniquement un outil, content est facultatif. L’appel suit le format {id,type:"function",function:{name,arguments}}, où arguments est une chaîne 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":"Un cercle bleu sur fond blanc"}]}]}'
Réponse
La réponse peut contenir plusieurs trames JSON. Traitez-les selon le Content-Type reçu. L’URL finale se trouve dans choices[0].delta.image.url, avec les dimensions dans width et height. Une génération réussie peut avoir un finish_reason nul. Vérifiez l’URL et téléchargez l’image avant son expiration. Pour poursuivre la retouche, réutilisez assembled_history. Conservez le request_id en cas d’erreur ou de coupure. Relancer une génération peut occasionner de nouveaux frais.
Facturation
La passerelle réserve un crédit puis facture une fois d’après tokenhub_usage.total_tokens. Le prix APIMaster en vigueur figure sur la fiche du modèle.
