Passer au contenu

Trellis 2 · Retexture

Intégrer

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

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

Cette requête: 0,24 $ 240 crédits API L’exécuter sur cette page

Obtenir une clé API
Microsoft Image vers 3D #image-to-3d

Retexture un maillage 3D existant sans texture pour l’adapter à une image de référence, avec une sortie GLB

Microsoft · 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 image_url
Déposez un fichier, ou

URL de l’image de référence utilisée pour appliquer la texture.

resolution par défaut 1024

Les détails de texture et la vitesse de traitement dépendent de cette résolution de génération interne : l’augmenter produit des détails plus fins, mais allonge le traitement.

•requis

URL source de retexturation pour un maillage 3D sans texture aux formats GLB, OBJ, PLY ou STL.

Avancé texture_size · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · seed
texture_size par défaut 2048

Résolution de texture du maillage pour la cuisson. Une résolution accrue offre des détails de surface plus fins, mais produit des fichiers plus volumineux.

par défaut 1

Contrôle de fidélité des couleurs de texture : une adhérence plus étroite aux couleurs de l’image d’entrée avec des réglages élevés augmente l’intensité, mais peut provoquer une sursaturation.

par défaut 0

Augmentez ce paramètre pour corriger les textures bruitées ou les bandes de couleur : il réduit les artefacts causés par un guidage fort lors de l’étape de texture.

par défaut 0.6

Point d’activation du guidage sans classifieur pour la génération de texture. Exprimé comme fraction de la progression du débruitage, il définit interval_start ; le guidage ne s’applique que dans la fenêtre délimitée par interval_start et interval_end.

par défaut 0.9

Limite d’arrêt du guidage sans classifieur de l’étape de texture, spécifiée comme fraction du débruitage et au moins égale à tex_slat_guidance_interval_start.

par défaut 12

Nombre d’étapes de débruitage utilisées pour générer les textures. Augmenter ce nombre prend plus de temps, mais peut produire des textures plus propres.

par défaut 3

Définissez la netteté des détails de texture via le calendrier de bruit de génération de texture ; augmenter cette valeur produit des détails plus nets.

Graine utilisée pour une génération aléatoire reproductible.

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

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 Trellis 2 · Retexture

Applique une nouvelle texture au maillage de `mesh_url` (GLB, OBJ, PLY ou STL) à partir d’une image de référence `image_url`. `resolution` vaut 512 ou 1024, et `texture_size` vaut 1024, 2048 ou 4096. Des contrôles de guidage et d’échantillonnage pour la phase de texture sont disponibles. La géométrie n’est pas régénérée.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
URL de l’image de référence utilisée pour appliquer la texture.
mesh_urlrequis
Typestring
URL source de retexturation pour un maillage 3D sans texture aux formats GLB, OBJ, PLY ou STL.
seedfacultatif
Typeinteger | null
Graine utilisée pour une génération aléatoire reproductible.
resolutionfacultatif
Typeenum
Par défaut1024
5121024
Les détails de texture et la vitesse de traitement dépendent de cette résolution de génération interne : l’augmenter produit des détails plus fins, mais allonge le traitement.
tex_slat_guidance_strengthfacultatif
Typenumber
Par défaut1
0 – 10
Contrôle de fidélité des couleurs de texture : une adhérence plus étroite aux couleurs de l’image d’entrée avec des réglages élevés augmente l’intensité, mais peut provoquer une sursaturation.
tex_slat_guidance_rescalefacultatif
Typenumber
Par défaut0
0 – 1
Augmentez ce paramètre pour corriger les textures bruitées ou les bandes de couleur : il réduit les artefacts causés par un guidage fort lors de l’étape de texture.
tex_slat_guidance_interval_startfacultatif
Typenumber
Par défaut0.6
0 – 1
Point d’activation du guidage sans classifieur pour la génération de texture. Exprimé comme fraction de la progression du débruitage, il définit interval_start ; le guidage ne s’applique que dans la fenêtre délimitée par interval_start et interval_end.
tex_slat_guidance_interval_endfacultatif
Typenumber
Par défaut0.9
0 – 1
Limite d’arrêt du guidage sans classifieur de l’étape de texture, spécifiée comme fraction du débruitage et au moins égale à tex_slat_guidance_interval_start.
tex_slat_sampling_stepsfacultatif
Typeinteger
Par défaut12
1 – 50
Nombre d’étapes de débruitage utilisées pour générer les textures. Augmenter ce nombre prend plus de temps, mais peut produire des textures plus propres.
tex_slat_rescale_tfacultatif
Typenumber
Par défaut3
1 – 6
Définissez la netteté des détails de texture via le calendrier de bruit de génération de texture ; augmenter cette valeur produit des détails plus nets.
texture_sizefacultatif
Typeenum
Par défaut2048
102420484096
Résolution de texture du maillage pour la cuisson. Une résolution accrue offre des détails de surface plus fins, mais produit des fichiers plus volumineux.
requis Nom canonique, également accepté

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": "trellis-2/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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
    }
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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}Modèle 3D généré au format GLB.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/trellis-2/retexture.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt