Passer au contenu principal

Démarrage rapide

La génération 3D est une opération asynchrone, l’ensemble du processus se déroule en trois étapes :
Exemple minimal

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
  • prompt et input_references sont mutuellement exclusifs (un seul des deux peut être fourni) ; seul generate_type: "Sketch" autorise leur passage simultané (esquisse + description textuelle).
  • Dans chaque élément de input_references, exactement un des champs image_url et image_base64 doit être fourni :
    • image_url ne prend en charge que les URL publiques http(s), les data URL ne sont pas prises en charge (utilisez image_base64 à la place) ;
    • image_base64 ne doit pas dépasser 6 Mo une fois décodé.
  • hy-3d-3.1 ne prend pas en charge le type de génération LowPoly.
  • 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

Interrogez cette interface pour vérifier si la tâche est terminée. Il est recommandé d’interroger toutes les 10 à 15 secondes. L’interrogation n’est pas facturée.

Exemple de réponse (génération terminée)

Description des champs de output[]
content_url et preview_url sont des liens temporaires qui expirent après un certain temps ; veuillez télécharger et transférer les fichiers vers votre propre stockage dès que la tâche est terminée. L’ID de tâche reste interrogeable pendant 24 heures à compter de sa création (le champ expires_at indique l’échéance d’interrogation) ; passé ce délai, l’interrogation renvoie une erreur. Les liens temporaires ne prennent en charge que les requêtes GET ; les requêtes HEAD renvoient une erreur 403.

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_at de la réponse indique l’échéance d’interrogation.
  • content_url / preview_url sont 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 ?

Lorsque status est failed, le champ error de la réponse contient les informations sur l’erreur :
Les causes courantes d’échec incluent : contenu non conforme, format d’image non pris en charge, image de référence inaccessible, etc. Veuillez ajuster en fonction du message d’erreur puis réessayer.
Dernière mise à jour : 2026-07-17