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-CA/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) par l’intermédiaire de Doitong API. Documentation pour les agents : https://doitong.com/fr-CA/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 l’état 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 de structure, de forme, de texture et d’UV

OpenAPI Markdown

Microsoft · 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.

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 demande 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 meilleure concordance 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, qui privilégie des effets de guidage plus forts avec des valeurs faibles et une sortie plus stable avec des valeurs élevées.

ss_guidance_interval_start par défaut 0.6

Début de la fenêtre de guidage sans classifieur à l’étape 1 (structure clairsemée), exprimé comme fraction de réduction du bruit. Des valeurs plus basses commencent le guidage plus tôt ; seul l’intervalle de interval_start à interval_end utilise le guidage, le traitement étant sans guidage ailleurs.

ss_guidance_interval_end par défaut 1

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

ss_sampling_steps par défaut 12

Nombre de débruitages de la structure initiale : les gains de qualité potentiels liés aux étapes supplémentaires ralentissent le traitement.

ss_rescale_t par défaut 5

Définit la netteté de la transition via le programme 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 pendant l’étape de forme.

shape_slat_guidance_interval_start par défaut 0.6

Point d’activation du guidage sans classifieur pour le raffinement de la forme à l’étape 2. Exprimé comme fraction de la progression de réduction du bruit, il définit interval_start ; le guidage opère uniquement dans la fenêtre délimitée par interval_start et interval_end.

shape_slat_guidance_interval_end par défaut 1

Seuil d’arrêt du guidage à l’étape 2 (raffinement de la forme) : choisissez une valeur au moins égale à shape_slat_guidance_interval_start. Cette valeur indique la fraction de réduction du bruit atteinte lorsque le guidage sans classifieur s’arrête.

shape_slat_sampling_steps par défaut 12

Nombre de débruitages 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éfinit la netteté des détails géométriques via le programme 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 meilleure adhérence aux couleurs de l’image d’entrée avec des valeurs élevées augmente l’éclat, mais peut entraîner 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 pendant 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 de réduction du bruit, il définit interval_start ; le guidage opère uniquement dans la fenêtre délimitée par interval_start et interval_end.

tex_slat_guidance_interval_end par défaut 0.9

Seuil d’arrêt du guidage à l’étape 3 (texture) : choisissez une valeur au moins égale à tex_slat_guidance_interval_start. Cette valeur indique la fraction de réduction du bruit 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 nettes.

tex_slat_rescale_t par défaut 3

Définit la netteté des détails de texture via le programme 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 et le mobile. Réduire la cible diminue les détails du maillage au profit de fichiers plus petits.

remesh_band par défaut 1

Amplitude de déplacement lors de la reconstitution du maillage : un lissage supplémentaire peut sacrifier les détails fins lorsque cette valeur augmente. Le paramètre limite le déplacement des sommets par rapport à la surface originale.

remesh_project par défaut 0

Intensité de projection pour ramener les sommets reconstitués sur la surface originale : 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 cartes UV en degrés, qui restreint la différence entre les normales de faces voisines au sein d’une carte. Augmenter la limite favorise des cartes moins nombreuses et plus grandes, au risque d’étirement ; la réduire favorise davantage de cartes et moins de distorsion.

uv_unwrap_refine_iterations par défaut 0

Nombre de passes de raffinement local utilisées pour calculer les cartes UV.

uv_unwrap_global_iterations par défaut 1

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

uv_unwrap_smooth_strength par défaut 1

Ajuste l’intensité du lissage des bords des cartes 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 au 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 un élément 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 réglages 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 demande 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 meilleure concordance 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, qui privilégie des effets de guidage plus forts avec des valeurs faibles et une sortie plus stable avec des valeurs élevées.

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 de débruitages de la structure initiale : les gains de qualité potentiels liés aux étapes supplémentaires ralentissent le traitement.

ss_rescale_tfacultatif

Typenumber

Par défaut5

1 – 6

Définit la netteté de la transition via le programme 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 pendant 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 de débruitages 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éfinit la netteté des détails géométriques via le programme 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 pendant 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 nettes.

tex_slat_rescale_tfacultatif

Typenumber

Par défaut3

1 – 6

Définit la netteté des détails de texture via le programme 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’adaptation à des usages ultérieurs 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 de raffinement local utilisées pour calculer les cartes UV.

uv_unwrap_global_iterationsfacultatif

Typeinteger

Par défaut1

1 – 10

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

uv_unwrap_smooth_strengthfacultatif

Typenumber

Par défaut1

0 – 10

Ajuste l’intensité du lissage des bords des cartes 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 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}Modèle 3D généré au format GLB.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/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 de 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