Passer au contenu

Hunyuan3d V3 · Sketch to 3D

Intégrer

Identifiant du modèle hunyuan3d-v3/sketch-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/sketch-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",
    "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,30 ₽ 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 qui transforme un croquis ou un dessin au trait et un prompt textuel en modèle 3D

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

Spécifie les attributs du contenu 3D dans un prompt textuel, par exemple son matériau, sa couleur ou sa catégorie.

•requis
Déposez un fichier, ou

URL d'une image d'esquisse ou de line art à convertir en modèle 3D. Les dimensions d'image prises en charge vont de 128 × 128 à 5000 × 5000 pixels.

par défaut 500000

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

Avancé enable_safety_checker
POST /run/hunyuan3d-v3/sketch-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/sketch-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",
    "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 · Sketch to 3D

Nécessite une image de croquis ou de dessin au trait (`input_image_url`, de 128x128 à 5000x5000 pixels) et un `prompt` de 1024 caractères maximum décrivant la couleur, la catégorie et le matériau. `enable_pbr` active les matériaux PBR et `face_count` définit le nombre cible de polygones, de 40000 à 1500000. Renvoie un fichier GLB, les URL des autres formats et une miniature.

Paramètres

NomType Par défautAutorisé Description
input_image_urlrequis
Typeurl · image
URL d'une image d'esquisse ou de line art à convertir en modèle 3D. Les dimensions d'image prises en charge vont de 128 × 128 à 5000 × 5000 pixels.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
promptrequis
Typestring
≤ 1 024 caractères
Spécifie les attributs du contenu 3D dans un prompt textuel, par exemple son matériau, sa couleur ou sa catégorie.
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.
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/sketch-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",
    "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 : Image vers 3D

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