Passer 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

Génération 2D-vers-3D avec 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.

•requis image_url
Déposez un fichier, ou

URL de l’image source à convertir 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 requise.

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 dans 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 stabilisent davantage la sortie.

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 fraction du débruitage et au moins égal à 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 fraction du débruitage et au moins égal à 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 souhaité de sommets 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`, en appliquant éventuellement des 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 contrôles 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_urlrequis image
Typeurl · image
URL de l’image source à convertir 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 requise.
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 stabilisent davantage la sortie.
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 fraction du débruitage et au moins égal à 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 fraction du débruitage et au moins égal à 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 souhaité de sommets dans l’export GLB.
texture_sizefacultatif
Typeenum
Par défaut2048
102420484096
Résolution des textures intégrées dans l’export GLB.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
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-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 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 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
integerNombre cible de sommets appliqué à l’export GLB.
texture_size
integerRésolution des textures intégrées dans l’export GLB.

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