Accéder au contenu

TRELLIS.2 LoRA Inference

Intégrer

Identifiant du modèle trellis-2-lora
# 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-lora?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"

Cette requête: 0,25 $ 250 crédits API L'exécuter sur cette page

Obtenir une clé API
Microsoft Image vers 3D

Image-vers-3D Trellis 2 pouvant appliquer des adaptateurs LoRA personnalisés à la structure, la géométrie et la texture

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.

•obligatoire image_url
Déposez un fichier ou

URL de l’image source pour la conversion en modèle 3D.

resolution par défaut 512

Résolution de génération ; 1024 sélectionne le pipeline en cascade. Choisissez la résolution utilisée pour entraîner les adaptateurs LoRA fournis ; une correspondance est obligatoire.

Avancé texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · 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 · seed · enable_safety_checker

Checkpoint LoRA facultatif au format safetensors, entraîné spécifiquement pour le débruiteur de texture.

texture_size par défaut 2048

Résolution des textures intégrées à l’export GLB.

Checkpoint LoRA facultatif au format safetensors, entraîné spécifiquement pour le débruiteur de structure clairsemée.

Checkpoint LoRA facultatif au format safetensors, entraîné spécifiquement pour le débruiteur de géométrie.

par défaut 7.5

Intensité du guidage sans classifieur pendant la génération de la structure clairsemée.

par défaut 0.7

Redimensionnement du guidage pendant la génération de la structure clairsemée. Des valeurs plus élevées rendent la sortie plus stable.

par défaut 0.6

Fraction de la progression du débruitage à laquelle commence le guidage de la structure clairsemée.

par défaut 1

Utilisez une fraction de débruitage supérieure ou égale à `ss_guidance_interval_start` pour indiquer quand le guidage de la structure clairsemée s’arrête.

par défaut 12

Nombre d’étapes de débruitage utilisées pendant la génération de la structure clairsemée.

par défaut 5

Netteté du calendrier de bruit pendant la génération de la structure clairsemée.

par défaut 7.5

Intensité du guidage sans classifieur pendant la génération de la forme.

par défaut 0.5

Redimensionnement appliqué au guidage pendant la génération de la forme ; augmentez-le lorsque la géométrie semble bruitée.

par défaut 0.6

Fraction du débruitage à laquelle commence le guidage de l’étape de forme.

par défaut 1

Point d’arrêt du guidage de l’étape de forme, exprimé comme une fraction du débruitage au moins égale à shape_slat_guidance_interval_start.

par défaut 12

Nombre d’étapes de débruitage pendant la génération de la forme.

par défaut 3

Netteté du calendrier de bruit pendant la génération de la forme.

par défaut 1

Intensité du guidage sans classifieur pendant la génération de texture.

par défaut 0

Redimensionnement appliqué au guidage pendant la génération de texture ; augmentez-le lorsque les textures semblent bruitées.

par défaut 0.6

Fraction du débruitage à laquelle commence le guidage de l’étape de texture.

par défaut 0.9

Point d’arrêt du guidage de l’étape de texture, exprimé comme une fraction du débruitage au moins égale à tex_slat_guidance_interval_start.

par défaut 12

Nombre d’étapes de débruitage pendant la génération de texture.

par défaut 3

Netteté du calendrier de bruit pendant la génération de texture.

par défaut 500000

Nombre de sommets souhaité dans l’export GLB.

Seed aléatoire rendant la génération reproductible.

POST /run/trellis-2-lora?wait=20 devis → 0,25 $
# 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-lora?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"

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 LoRA Inference

Génère un GLB depuis `image_url`, avec application facultative de LoRA safetensors via `sparse_structure_lora_url`, `geometry_lora_url` et `texture_lora_url`. `resolution` vaut 512 ou 1024 et doit correspondre à la résolution d’entraînement des adaptateurs. Les réglages de guidage et d’étapes par phase, `decimation_target` et `texture_size` sont également disponibles.

Paramètres

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

NomType Par défautAutorisé Description
image_urlobligatoire image
Typeurl · image
URL de l’image source pour la conversion en modèle 3D.
sparse_structure_lora_urlfacultatif
Typestring | null
Checkpoint LoRA facultatif au format safetensors, entraîné spécifiquement pour le débruiteur de structure clairsemée.
geometry_lora_urlfacultatif
Typestring | null
Checkpoint LoRA facultatif au format safetensors, entraîné spécifiquement pour le débruiteur de géométrie.
texture_lora_urlfacultatif
Typestring | null
Checkpoint LoRA facultatif au format safetensors, entraîné spécifiquement pour le débruiteur de texture.
seedfacultatif
Typeinteger | null
Seed aléatoire rendant la génération reproductible.
resolutionfacultatif
Typeenum
Par défaut512
5121024
Résolution de génération ; 1024 sélectionne le pipeline en cascade. Choisissez la résolution utilisée pour entraîner les adaptateurs LoRA fournis ; une correspondance est obligatoire.
ss_guidance_strengthfacultatif
Typenumber
Par défaut7.5
0 – 10
Intensité du guidage sans classifieur pendant la génération de la structure clairsemée.
ss_guidance_rescalefacultatif
Typenumber
Par défaut0.7
0 – 1
Redimensionnement du guidage pendant la génération de la structure clairsemée. Des valeurs plus élevées rendent la sortie plus stable.
ss_guidance_interval_startfacultatif
Typenumber
Par défaut0.6
0 – 1
Fraction de la progression du débruitage à laquelle commence le guidage de la structure clairsemée.
ss_guidance_interval_endfacultatif
Typenumber
Par défaut1
0 – 1
Utilisez une fraction de débruitage supérieure ou égale à `ss_guidance_interval_start` pour indiquer quand le guidage de la structure clairsemée s’arrête.
ss_sampling_stepsfacultatif
Typeinteger
Par défaut12
1 – 50
Nombre d’étapes de débruitage utilisées pendant la génération de la structure clairsemée.
ss_rescale_tfacultatif
Typenumber
Par défaut5
1 – 6
Netteté du calendrier de bruit pendant la génération de la structure clairsemée.
shape_slat_guidance_strengthfacultatif
Typenumber
Par défaut7.5
0 – 10
Intensité du guidage sans classifieur pendant la génération de la forme.
shape_slat_guidance_rescalefacultatif
Typenumber
Par défaut0.5
0 – 1
Redimensionnement appliqué au guidage pendant la génération de la forme ; augmentez-le lorsque la géométrie semble bruitée.
shape_slat_guidance_interval_startfacultatif
Typenumber
Par défaut0.6
0 – 1
Fraction du débruitage à laquelle commence le guidage de l’étape de forme.
shape_slat_guidance_interval_endfacultatif
Typenumber
Par défaut1
0 – 1
Point d’arrêt du guidage de l’étape de forme, exprimé comme une fraction du débruitage au moins égale à shape_slat_guidance_interval_start.
shape_slat_sampling_stepsfacultatif
Typeinteger
Par défaut12
1 – 50
Nombre d’étapes de débruitage pendant la génération de la forme.
shape_slat_rescale_tfacultatif
Typenumber
Par défaut3
1 – 6
Netteté du calendrier de bruit pendant la génération de la forme.
tex_slat_guidance_strengthfacultatif
Typenumber
Par défaut1
0 – 10
Intensité du guidage sans classifieur pendant la génération de texture.
tex_slat_guidance_rescalefacultatif
Typenumber
Par défaut0
0 – 1
Redimensionnement appliqué au guidage pendant la génération de texture ; augmentez-le lorsque les textures semblent bruitées.
tex_slat_guidance_interval_startfacultatif
Typenumber
Par défaut0.6
0 – 1
Fraction du débruitage à laquelle commence le guidage de l’étape de texture.
tex_slat_guidance_interval_endfacultatif
Typenumber
Par défaut0.9
0 – 1
Point d’arrêt du guidage de l’étape de texture, exprimé comme une fraction du débruitage au moins égale à tex_slat_guidance_interval_start.
tex_slat_sampling_stepsfacultatif
Typeinteger
Par défaut12
1 – 50
Nombre d’étapes de débruitage pendant la génération de texture.
tex_slat_rescale_tfacultatif
Typenumber
Par défaut3
1 – 6
Netteté du calendrier de bruit pendant la génération de texture.
decimation_targetfacultatif
Typeinteger
Par défaut500000
5 000 – 2 000 000
Nombre de sommets souhaité dans l’export GLB.
texture_sizefacultatif
Typeenum
Par défaut2048
102420484096
Résolution des textures intégrées à l’export GLB.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
obligatoire 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-lora",
  "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": 250,
    "usd": "0.25",
    "charged": 250,
    "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
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "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 sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'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}Fichier GLB contenant le modèle 3D généré.
seed
integerSeed appliqué pendant la génération.
resolution
integerRésolution à laquelle la génération a été effectuée.
sparse_structure_lora_url
string | nullCheckpoint LoRA de structure clairsemée utilisé pendant la génération, le cas échéant.
geometry_lora_url
string | nullCheckpoint LoRA de géométrie utilisé pendant la génération, le cas échéant.
texture_lora_url
string | nullCheckpoint LoRA de texture utilisé pendant la génération, le cas échéant.
decimation_target
integerCible de nombre de sommets appliquée à l’export GLB.
texture_size
integerRésolution des textures intégrées à l’export GLB.

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