Trellis 2

Intégrer

Identifiant du modèle trellis-2

# 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?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"
  }'

# 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/fr/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "trellis-2",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Appelez le modèle Trellis 2 (trellis-2) via la Doitong API. Documentation pour les agents : https://doitong.com/fr/developers/models/trellis-2.md

POST https://api.doitong.com/v1/run/trellis-2?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Si le statut de la réponse est "queued" ou "running", interrogez GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 jusqu’à ce qu’il soit "succeeded" ; les fichiers se trouvent dans outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 avec le même corps renvoie le prix exact avant l’exécution.

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

Obtenir une clé API

Microsoft Image vers 3D #image-to-3d

Transforme une image unique en maillage 3D GLB texturé avec réglages ajustables de structure, de forme, de texture et d’UV

OpenAPI Markdown

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.

image •requis image_url

Déposez un fichier, ou

URL pointant vers l’image source pour la conversion 3D.

resolution par défaut 1024

Résolution de la sortie ; l’augmenter ajoute des détails mais prend plus de temps.

Avancé texture_size · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · 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 · decimation_target · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh

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.

ss_guidance_strength par défaut 7.5

Contrôle initial de fidélité de la structure 3D : l’augmenter favorise une correspondance plus étroite avec l’image d’entrée au risque d’ajouter du bruit.

ss_guidance_rescale par défaut 0.7

Contrôle des artefacts de guidage de l’étape 1, privilégiant des effets de guidage plus forts avec des réglages faibles et une sortie plus stable avec des réglages élevés.

ss_guidance_interval_start par défaut 0.6

Début de la fenêtre de guidage sans classifieur de l’étape 1 (structure clairsemée), exprimé comme fraction du débruitage. Des valeurs plus faibles commencent le guidage plus tôt ; seul l’intervalle de interval_start à interval_end utilise le guidage, le reste étant traité sans guidage.

ss_guidance_interval_end par défaut 1

Limite du guidage de l’étape 1 (structure clairsemée) : choisissez une valeur au moins égale à ss_guidance_interval_start. Elle indique la fraction du débruitage atteinte lorsque le guidage sans classifieur s’arrête.

ss_sampling_steps par défaut 12

Nombre d’étapes de débruitage de la structure initiale : les gains de qualité potentiels liés à des étapes supplémentaires s’accompagnent d’un traitement plus lent.

ss_rescale_t par défaut 5

Définissez la netteté des transitions via le calendrier de bruit de génération de la structure : augmenter cette valeur rend les transitions plus nettes.

shape_slat_guidance_strength par défaut 7.5

Contrôle de fidélité de la géométrie détaillée : une meilleure adhérence à l’image d’entrée produit davantage de détails, avec un risque de bruit supplémentaire.

shape_slat_guidance_rescale par défaut 0.5

Augmentez ce paramètre lorsque la géométrie semble bruitée : il réduit les artefacts causés par un guidage fort lors de l’étape de forme.

shape_slat_guidance_interval_start par défaut 0.6

Point d’activation du guidage sans classifieur pour l’affinement de la forme à l’étape 2. 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.

shape_slat_guidance_interval_end par défaut 1

Limite du guidage de l’étape 2 (affinement de la forme) : choisissez une valeur au moins égale à shape_slat_guidance_interval_start. Elle indique la fraction du débruitage atteinte lorsque le guidage sans classifieur s’arrête.

shape_slat_sampling_steps par défaut 12

Nombre d’étapes de débruitage du raffinement de la forme : une géométrie potentiellement plus lisse se fait au détriment de la vitesse lorsque des étapes supplémentaires sont utilisées.

shape_slat_rescale_t par défaut 3

Définissez la netteté des détails géométriques via le calendrier de bruit du raffinement de la forme ; augmenter cette valeur produit des détails plus nets.

tex_slat_guidance_strength 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.

tex_slat_guidance_rescale 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.

tex_slat_guidance_interval_start par défaut 0.6

Point d’activation du guidage sans classifieur pour la génération de texture à l’étape 3. 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_end par défaut 0.9

Limite du guidage de l’étape 3 (texture) : choisissez une valeur au moins égale à tex_slat_guidance_interval_start. Elle indique la fraction du débruitage atteinte lorsque le guidage sans classifieur s’arrête.

tex_slat_sampling_steps 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.

tex_slat_rescale_t 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.

decimation_target par défaut 500000

Nombre cible de sommets du maillage : 500k est recommandé pour une utilisation générale et 20k–50k pour le web/mobile. Réduire la cible sacrifie des détails du maillage au profit de fichiers plus petits.

remesh_band par défaut 1

Marge de déplacement du rem maillage : un lissage supplémentaire peut sacrifier les détails fins lorsque cette valeur augmente. Le réglage limite le déplacement des sommets par rapport à la surface d’origine.

remesh_project par défaut 0

Intensité de projection des sommets rem aillés vers la surface d’origine : 1 préserve les détails grâce à une projection complète, tandis que 0 désactive la projection pour un résultat plus lisse.

uv_unwrap_angle_threshold_deg par défaut 90

Limite d’angle des chartes UV en degrés, restreignant l’écart entre les normales de faces voisines au sein d’une charte. Une limite plus élevée favorise des chartes moins nombreuses et plus grandes, au risque d’étirements ; une limite plus faible favorise davantage de chartes et moins de distorsion.

uv_unwrap_refine_iterations par défaut 0

Nombre de passes d’affinement local utilisées pour calculer les chartes UV.

uv_unwrap_global_iterations par défaut 1

L’équilibre des chartes UV peut être amélioré en augmentant ce nombre de passes de regroupement global utilisées pour calculer les chartes.

uv_unwrap_smooth_strength par défaut 1

Ajuste l’intensité du lissage des bords des chartes UV ; des raccords moins visibles avec des valeurs élevées comportent un risque de distorsion UV.

seed

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

POST /run/trellis-2?wait=20 devis → 0,30 $

# 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?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"
  }'

# 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "trellis-2",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

Exécuter cette requête

Clé API

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. Mémoriser dans ce navigateur Obtenir une clé API

À propos de Trellis 2

Construit une ressource 3D à partir d’une image (`image_url`) et renvoie un fichier GLB. `resolution` vaut 512, 1024 ou 1536, et `texture_size` vaut 1024, 2048 ou 4096. Chacune des trois étapes (structure, forme, texture) possède ses propres contrôles de guidage et d’étapes d’échantillonnage. `decimation_target` définit le nombre de sommets du maillage (5,000 à 2,000,000), et des options de remeshing et de dépliage UV sont disponibles.

Paramètres

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

NomType Par défautAutorisé Description

seedfacultatif

Typeinteger | null

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

resolutionfacultatif

Typeenum

Par défaut1024

51210241536

Résolution de la sortie ; l’augmenter ajoute des détails mais prend plus de temps.

ss_guidance_strengthfacultatif

Typenumber

Par défaut7.5

0 – 10

Contrôle initial de fidélité de la structure 3D : l’augmenter favorise une correspondance plus étroite avec l’image d’entrée au risque d’ajouter du bruit.

ss_guidance_rescalefacultatif

Typenumber

Par défaut0.7

0 – 1

Contrôle des artefacts de guidage de l’étape 1, privilégiant des effets de guidage plus forts avec des réglages faibles et une sortie plus stable avec des réglages élevés.

ss_guidance_interval_startfacultatif

Typenumber

Par défaut0.6

0 – 1

ss_guidance_interval_endfacultatif

Typenumber

Par défaut1

0 – 1

ss_sampling_stepsfacultatif

Typeinteger

Par défaut12

1 – 50

Nombre d’étapes de débruitage de la structure initiale : les gains de qualité potentiels liés à des étapes supplémentaires s’accompagnent d’un traitement plus lent.

ss_rescale_tfacultatif

Typenumber

Par défaut5

1 – 6

Définissez la netteté des transitions via le calendrier de bruit de génération de la structure : augmenter cette valeur rend les transitions plus nettes.

shape_slat_guidance_strengthfacultatif

Typenumber

Par défaut7.5

0 – 10

Contrôle de fidélité de la géométrie détaillée : une meilleure adhérence à l’image d’entrée produit davantage de détails, avec un risque de bruit supplémentaire.

shape_slat_guidance_rescalefacultatif

Typenumber

Par défaut0.5

0 – 1

Augmentez ce paramètre lorsque la géométrie semble bruitée : il réduit les artefacts causés par un guidage fort lors de l’étape de forme.

shape_slat_guidance_interval_startfacultatif

Typenumber

Par défaut0.6

0 – 1

shape_slat_guidance_interval_endfacultatif

Typenumber

Par défaut1

0 – 1

shape_slat_sampling_stepsfacultatif

Typeinteger

Par défaut12

1 – 50

Nombre d’étapes de débruitage du raffinement de la forme : une géométrie potentiellement plus lisse se fait au détriment de la vitesse lorsque des étapes supplémentaires sont utilisées.

shape_slat_rescale_tfacultatif

Typenumber

Par défaut3

1 – 6

Définissez la netteté des détails géométriques via le calendrier de bruit du raffinement de la forme ; augmenter cette valeur produit des détails plus nets.

tex_slat_guidance_strengthfacultatif

Typenumber

Par défaut1

0 – 10

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

tex_slat_guidance_interval_endfacultatif

Typenumber

Par défaut0.9

0 – 1

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.

decimation_targetfacultatif

Typeinteger

Par défaut500000

5 000 – 2 000 000

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.

remeshfacultatif

Typeboolean

Par défauttrue

Reconstruction de la topologie créant des triangles de maillage plus propres, ce qui améliore généralement l’utilisation ultérieure, comme l’animation ou l’impression 3D, au prix d’un traitement plus lent.

remesh_bandfacultatif

Typenumber

Par défaut1

0 – 4

remesh_projectfacultatif

Typenumber

Par défaut0

0 – 1

uv_unwrap_angle_threshold_degfacultatif

Typenumber

Par défaut90

0 – 180

uv_unwrap_refine_iterationsfacultatif

Typeinteger

Par défaut0

0 – 10

Nombre de passes d’affinement local utilisées pour calculer les chartes UV.

uv_unwrap_global_iterationsfacultatif

Typeinteger

Par défaut1

1 – 10

L’équilibre des chartes UV peut être amélioré en augmentant ce nombre de passes de regroupement global utilisées pour calculer les chartes.

uv_unwrap_smooth_strengthfacultatif

Typenumber

Par défaut1

0 – 10

Ajuste l’intensité du lissage des bords des chartes UV ; des raccords moins visibles avec des valeurs élevées comportent un risque de distorsion UV.

image_urlrequis image

Typeurl · image

URL pointant vers l’image source pour la conversion 3D.

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",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "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
    }
  },
  "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.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt

Votre premier résultat apparaîtra ici

Créer une requête

Exécuter cette requête

À propos de Trellis 2

Paramètres

Sortie

Autres variantes Trellis 2

Trellis 2 · Retexture Variantes : 2

Plus de modèles : Image vers 3D

Trellis Variantes : 2

Trellis · Multi Variantes : 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Variantes : 6