Passer au contenu

Hunyuan3d V3 · Text to 3D

Intégrer

Identifiant du modèle hunyuan3d-v3/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Texte vers 3D

Hunyuan3D V3, conversion de texte en 3D avec sortie Normal, LowPoly ou Geometry et option PBR

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 88 / 1024

Prompt de génération autorisant jusqu'à 1024 caractères UTF-8 pour spécifier le contenu 3D à créer.

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/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 · Text to 3D

Génère un modèle 3D à partir d’un `prompt` de 1024 caractères maximum, sans image nécessaire. `generate_type` choisit un modèle Normal texturé, une réduction LowPoly ou un modèle Geometry blanc ; `polygon_type` définit triangle ou quadrilateral pour LowPoly. `enable_pbr` ajoute des matériaux PBR et `face_count` va de 40000 à 1500000.

Paramètres

NomType Par défautAutorisé Description
promptrequis
Typestring
≤ 1 024 caractères
Prompt de génération autorisant jusqu'à 1024 caractères UTF-8 pour spécifier le contenu 3D à créer.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
enable_pbrfacultatif
Typeboolean
Par défautfalse
Interrupteur de génération des matériaux PBR.
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

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/text-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": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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 : Texte vers 3D

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