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, modes PBR et low-poly facultatifs

Tencent · 3D

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•requis
Déposez un fichier ou

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

Déposez un fichier ou

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

Déposez un fichier ou

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

Déposez un fichier ou

URL facultative d'une image vue de 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 souhaité de faces, de 40,000 à 1,500,000.

Avancé polygon_type · enable_safety_checker
polygon_type par défaut triangle

Type de polygones, appliqué uniquement si `GenerateType` est `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 au 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. Retourne un GLB, les URL d’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 d'un modèle 3D.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
La vérification peut être assouplie en définissant false, si l’appelant est autorisé.
back_image_urlfacultatif
Typeurl · image
URL facultative d'une image vue arrière, fournie pour améliorer la reconstruction 3D.
left_image_urlfacultatif
Typeurl · image
URL facultative d'une image vue de gauche, fournie pour améliorer la reconstruction 3D.
right_image_urlfacultatif
Typeurl · image
URL facultative d'une image vue de 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; dans ce cas, ce réglage n'a aucun effet.
face_countfacultatif
Typeinteger
Par défaut500000
40 000 – 1 500 000
Nombre souhaité de faces, de 40,000 à 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 polygones, appliqué uniquement si `GenerateType` est `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 par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au 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 divers 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 en Markdown se trouve à https://doitong.com/fr-CA/developers/models/hunyuan3d-v3/image-to-3d.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt