Démarrage rapide
La génération 3D est une opération asynchrone, l’ensemble du processus se déroule en trois étapes :Aperçu des interfaces
Base URL :
https://aihubmix.com
Méthode d’authentification : Bearer Token
Contrairement à l’interface vidéo, l’interface 3D ne dispose pas de point de terminaison de téléchargement
/content ni de point de terminaison de suppression DELETE : les fichiers produits se téléchargent directement via le champ content_url du tableau output[] de la réponse d’interrogation.Modèles pris en charge
Types de génération (
generate_type)
Description détaillée de l’API
En-têtes de requête
Créer une tâche de génération 3D
Corps de la requête
Règles de validation des paramètres
promptetinput_referencessont mutuellement exclusifs (un seul des deux peut être fourni) ; seulgenerate_type: "Sketch"autorise leur passage simultané (esquisse + description textuelle).- Dans chaque élément de
input_references, exactement un des champsimage_urletimage_base64doit être fourni :image_urlne prend en charge que les URL publiqueshttp(s), les data URL ne sont pas prises en charge (utilisezimage_base64à la place) ;image_base64ne doit pas dépasser 6 Mo une fois décodé.
hy-3d-3.1ne prend pas en charge le type de générationLowPoly.- La taille totale du corps de la requête ne doit pas dépasser 10 Mo.
Utilisation de
extra_body : les paramètres natifs de l’amont (par ex. polygon_type) peuvent être placés au niveau supérieur de extra_body pour être transmis tels quels. Les paramètres suivants doivent être passés en champs de premier niveau ; leur présence dans extra_body renvoie une erreur 400 : model, prompt, image_url, image_base64, generate_type, enable_pbr, face_count, result_format ; multi_view_images (images multi-vues) n’est pas encore pris en charge.Exemple de réponse
Description des valeurs de statut
Interroger le statut de la tâche
Exemple de réponse (génération terminée)
output[]
Exemples d’utilisation
Exemple d’appel complet
Facturation
- Facturation à la tâche : le prix est déterminé par la combinaison
modèle × generate_type × activation du PBR × nombre de faces spécifié × format spécifié; les tarifs détaillés sont disponibles sur la galerie de modèles. - La facturation intervient au moment de la création réussie de la tâche ; l’interrogation du statut et le téléchargement des fichiers ne sont pas facturés.
- Une combinaison de paramètres sans tarif configuré renvoie directement une erreur 400 à la création, sans aucun débit.
FAQ
Combien de temps prend la génération 3D ?
Généralement plusieurs minutes, le temps exact dépend du modèle, du type de génération et du nombre de faces défini. Il est recommandé d’interroger l’interface de consultation à un intervalle de 10 à 15 secondes.Quelle est la durée de validité des liens de fichiers et de la tâche ?
- L’ID de tâche reste interrogeable pendant 24 heures à compter de sa création ; le champ
expires_atde la réponse indique l’échéance d’interrogation. content_url/preview_urlsont des liens temporaires de l’amont qui expirent après un certain temps ; veuillez télécharger et sauvegarder au plus vite une fois la tâche terminée.
Peut-on passer prompt et une image de référence en même temps ?
Non, les deux sont mutuellement exclusifs — la seule exception est generate_type: "Sketch" (esquisse vers 3D), qui autorise le passage simultané d’une image d’esquisse et d’une description textuelle.
Quelles sont les différences entre les types de generate_type ?
Que faire en cas d’échec de la tâche ?
Lorsquestatus est failed, le champ error de la réponse contient les informations sur l’erreur :
Dernière mise à jour : 2026-07-17