APIMaster.ai

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.