TRELLIS.2 4B | EmpirioLabs AI Docs

Microsoft · 3D Generation

POST /v1/3d/generations

TRELLIS.2 modèle image-de-3D qui transforme une image de référence en un asset GLB texturé avec des contrôles de résolution, de graine, de maillage, de texture et d’exportation.

En un coup d’œil

Terrain	Valeur
Identifiant de modèle	`trellis-2-4b`
Date de sortie du modèle	-
Modalités d’entrée	Image
Modalités de sortie	3D
Fenêtre de contexte	-
Précision du poids	Mixte BF16/FP16
Caractéristiques	image_to_3d, glb_output, pbr_materials, seed_control, commercial_ready
Inférence autochtone	Oui
Nouveau	Oui
Points de terminaison pris en charge	`POST /v1/3d/generations`

Tarification

Charge	Spec	Taux
Actif 512	à la demande	$0.025 (était $0.25)
1024 actif	à la demande	$0.249 (était $0.30)
Atout de 1536	à la demande	$0.499

Exemple de demande

$ curl https://api.empiriolabs.ai/v1/3d/generations \
>   -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
>   -H 'Content-Type: application/json' \
>   -d '{"model": "trellis-2-4b", "image_url": "https://example.com/product-photo.png", "resolution": "1024", "texture_size": "2048"}'

Paramètres

Paramètre	Type	Obligatoire	Par défaut	Description
`image`	Image	Oui	-	URL d’image de référence, URI de données ou objet image téléchargé.
`resolution`	enum	non	`"1024"`	Résolution de la grille voxel. Les valeurs plus élevées sont plus lentes et plus détaillées. · Autorisé: `512`, `1024`, `1536`
`pipeline_type`	enum	non	`"1024_cascade"`	Pipeline TRELLIS explicite. Laissez sur la cascade 1024 sauf si vous avez besoin du chemin 512 ou 1536. · Autorisé: `512`, `1024_cascade`, `1536_cascade`
`seed`	entier	non	`42`	Graine aléatoire pour des générations reproductibles. · Plage: 0 – 2147483647
`preprocess_image`	Booléen	non	Vrai	Supprimez l’arrière-plan et normalisez l’image de référence avant la génération.
`max_num_tokens`	entier	non	`49152`	Maximum de jetons clairsemés utilisés pour la génération en cascade. · Répartition: 1024 – 131072
`ss_sampling_steps`	entier	non	`12`	Étapes d’échantillonneur pour la génération de structures clairsemées. · Répartition: 1 – 64
`ss_guidance_strength`	Nombre	non	`7.5`	Résistance au guidage pour la génération de structures clairsemées. · Plage: 0 – 20
`ss_guidance_rescale`	Nombre	non	`0.7`	Redimensionnement des guides pour la génération de structures clairsemées. · Plage: 0 – 2
`ss_guidance_interval_start`	Nombre	non	`0.6`	Début de l’intervalle de guidage à structure clairsemée. · Répartition: 0 – 1
`ss_guidance_interval_end`	Nombre	non	`1`	Fin de l’intervalle de guidage à structure clairsemée. · Répartition: 0 – 1
`ss_rescale_t`	Nombre	non	`5`	Redimensionnez la température pour une génération de structures clairsemées. · Plage: 0 – 20
`shape_slat_sampling_steps`	entier	non	`12`	Étapes d’échantillonneur pour la génération latente structurée par la forme. · Répartition: 1 – 64
`shape_slat_guidance_strength`	Nombre	non	`7.5`	Résistance au guidage pour la génération latente structurée par la forme. · Plage: 0 – 20
`shape_slat_guidance_rescale`	Nombre	non	`0.5`	Guidance redimensionnement pour la génération latente structurée par la forme. · Plage: 0 – 2
`shape_slat_guidance_interval_start`	Nombre	non	`0.6`	Début de l’intervalle de guidage SLat de forme. · Répartition: 0 – 1
`shape_slat_guidance_interval_end`	Nombre	non	`1`	Fin de l’intervalle de guidage SLat de forme. · Répartition: 0 – 1
`shape_slat_rescale_t`	Nombre	non	`3`	Redimensionnez la température pour une génération latente structurée par la forme. · Plage: 0 – 20
`tex_slat_sampling_steps`	entier	non	`12`	Étapes de sampler pour la génération latente structurée par texture. · Répartition: 1 – 64
`tex_slat_guidance_strength`	Nombre	non	`1`	Résistance de guidage pour la génération latente structurée par texture. · Plage: 0 – 20
`tex_slat_guidance_rescale`	Nombre	non	`0`	Guidance rescale pour la génération latente structurée par texture. · Plage: 0 – 2
`tex_slat_guidance_interval_start`	Nombre	non	`0.6`	Début de l’intervalle de guidage de texture SLat. · Répartition: 0 – 1
`tex_slat_guidance_interval_end`	Nombre	non	`0.9`	Fin de l’intervalle de guidage SLat de texture. · Répartition: 0 – 1
`tex_slat_rescale_t`	Nombre	non	`3`	Redimensionnez la température pour la génération latente structurée par la texture. · Plage: 0 – 20
`texture_size`	enum	non	`"2048"`	Résolution de texture cuite sur le matériau GLB. · Autorisé: `1024`, `2048`, `4096`
`decimation_target`	entier	non	`500000`	Nombre approximatif de sommets cibles pour le maillage exporté. · Portée: 10000 – 1000000
`remesh`	Booléen	non	Vrai	Reconstruis la topologie du maillage avant le dépliage UV et le baking des textures.
`remesh_band`	Nombre	non	`1`	Taille de bande remaillée. · Plage: 0 – 5
`remesh_project`	Nombre	non	`0.9`	Facteur de projection utilisé lors du remaillage. · Répartition: 0 – 1
`uv_unwrap_angle_threshold_deg`	Nombre	non	`90`	Seuil de demi-angle de cône utilisé pour le clustering UV unfold. · Portée: 1 – 180
`uv_unwrap_refine_iterations`	entier	non	`0`	Itérations de raffinement du clustering UV. · Plage: 0 – 10
`uv_unwrap_global_iterations`	entier	non	`1`	Itérations globales de clustering UV. · Plage: 0 – 10
`uv_unwrap_smooth_strength`	Nombre	non	`1`	Résistance au lissage des grappes UV. · Plage: 0 – 10
`response_format`	enum	non	`"url"`	Retournez par défaut les URL médias signées, ou le JSON base64 en ligne lorsque demandé. · Autorisé: `url`, `b64_json`
`verbose`	Booléen	non	faux	Activez la journalisation d’exportation de maillages verbose.

Notes

Par défaut

Pipeline en cascade 1024
12 pas d’échantillonneur par étape
Taille de texture 2048
Objectif de décimation de 500k
Sortie GLB

Contrôles

Prend en charge l’URL ou le téléchargement d’image, la résolution 512/1024/1536, la graine, le type de pipeline, les contrôles de guidance/interval/rescaling du sampler, la taille des textures, la décimation du maillage, le remeshing, le réglage UV déplié, ainsi que la sortie URL ou base64. La facturation est effectuée par actif 3D généré.

_Machine schéma lisible: _ GET https://api.empiriolabs.ai/v1/models/trellis-2-4b.