Passer au contenu

Hunyuan3d V3 · Image to 3D

Intégrer

Identifiant du modèle hunyuan3d-v3/image-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fichiers comme dans l’exemple: 0,375 $ 375 crédits API · ≈ 40,24 ₽ vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Tencent Image vers 3D

Hunyuan3D V3, conversion d’image en 3D avec vues arrière/gauche/droite, PBR et modes low-poly facultatifs

Tencent · 3D

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis
Déposez un fichier, ou

URL de l'image utilisée pour la génération du modèle 3D.

Déposez un fichier, ou

URL facultative de l'image vue arrière, fournie pour améliorer la reconstruction 3D.

Déposez un fichier, ou

URL facultative de l'image vue gauche, fournie pour améliorer la reconstruction 3D.

Déposez un fichier, ou

URL facultative de l'image vue droite, fournie pour améliorer la reconstruction 3D.

generate_type par défaut Normal

Mode de génération : `Normal` produit un modèle texturé ; `LowPoly` réduit le nombre de polygones ; `Geometry` produit un modèle blanc non texturé.

par défaut 500000

Nombre de faces souhaité, compris entre 40,000 et 1,500,000.

Avancé polygon_type · enable_safety_checker
polygon_type par défaut triangle

Type de polygone, appliqué uniquement si `GenerateType` vaut `LowPoly`.

POST /run/hunyuan3d-v3/image-to-3d?wait=20 devis → 0,375 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Hunyuan3d V3 · Image to 3D

Crée un modèle 3D à partir de `input_image_url`, avec `back_image_url`, `left_image_url` et `right_image_url` facultatifs pour améliorer la reconstruction. `generate_type` sélectionne Normal, LowPoly ou Geometry (sans texture), et `polygon_type` choisit triangle ou quadrilateral pour LowPoly. `enable_pbr` ajoute des matériaux PBR et `face_count` va de 40000 à 1500000. Renvoie un GLB, les URL des autres formats et une miniature.

Paramètres

NomType Par défautAutorisé Description
input_image_urlrequis
Typeurl · image
URL de l'image utilisée pour la génération du modèle 3D.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
back_image_urlfacultatif
Typeurl · image
URL facultative de l'image vue arrière, fournie pour améliorer la reconstruction 3D.
left_image_urlfacultatif
Typeurl · image
URL facultative de l'image vue gauche, fournie pour améliorer la reconstruction 3D.
right_image_urlfacultatif
Typeurl · image
URL facultative de l'image vue droite, fournie pour améliorer la reconstruction 3D.
enable_pbrfacultatif
Typeboolean
Par défautfalse
Génère des matériaux PBR sauf si generate_type est Geometry, auquel cas ce paramètre est sans effet.
face_countfacultatif
Typeinteger
Par défaut500000
40 000 – 1 500 000
Nombre de faces souhaité, compris entre 40,000 et 1,500,000.
generate_typefacultatif
Typeenum
Par défautNormal
NormalLowPolyGeometry
Mode de génération : `Normal` produit un modèle texturé ; `LowPoly` réduit le nombre de polygones ; `Geometry` produit un modèle blanc non texturé.
polygon_typefacultatif
Typeenum
Par défauttriangle
trianglequadrilateral
Type de polygone, appliqué uniquement si `GenerateType` vaut `LowPoly`.
requis

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/image-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
model_glb
object {url, content_type, file_name, file_size}Fichier GLB contenant l'objet 3D généré.
thumbnail
object {url, content_type, file_name, file_size} | nullVignette affichant un aperçu du modèle généré.
model_urls
object {glb, fbx, obj, usdz}Liens vers le modèle 3D dans différents formats.
seed
integer | nullValeur de la graine utilisée pendant la génération.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/hunyuan3d-v3/image-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt