TRELLIS.2 4B API

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

MicrosoftGénération 3DInférence native

À propos de TRELLIS.2 4B

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

Aussi connu sous le nom Microsoft TRELLIS.2 4B, TRELLIS.2-4B, trellis-2-4b

image to 3dglb outputpbr materialsseed controlcommercial ready

Caractéristiques de TRELLIS.2 4B

ID du modèle
trellis-2-4b
Fournisseur
Microsoft
Catégorie
Génération 3D
Publié
-
Entrée
Image
Sortie
3D
Endpoints
POST/v1/3d/generations
Identifiants de modèle alternatifs
microsoft/trellis.2-4btrellis-2

Tarifs de l'API TRELLIS.2 4BÉconomisez jusqu'à 90%

Tarifs à l'usage en direct du catalogue EmpirioLabs. Vous ne payez que ce que vous utilisez, sans minimum mensuel.

Type
Spéc.
Tarif
512 actifs
par demande
$0.25$0.025
1024 actifs
par demande
$0.30$0.249
1536 actifs
par demande
$0.499
Comparer sur la page complète des tarifs

Comment appeler l'API TRELLIS.2 4B

TRELLIS.2 4B fonctionne via POST /v1/3d/generations. La requête renvoie immédiatement un job_id ; interrogez GET /v1/jobs/{job_id} jusqu'à la fin du job et lisez les URLs de sortie dans le résultat. Obtenez une clé API depuis le tableau de bord EmpirioLabs.

cURL : envoyer le job
curl https://api.empiriolabs.ai/v1/3d/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "trellis-2-4b",
    "prompt": "Describe what you want TRELLIS.2 4B to generate."
  }'
cURL : interroger le résultat
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/3d/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "trellis-2-4b",
        "prompt": "Describe what you want TRELLIS.2 4B to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Référence complète de l'API TRELLIS.2 4B

Paramètres de l'API TRELLIS.2 4B

Paramètres de requête pris en charge par l'API TRELLIS.2 4B sur EmpirioLabs. Les valeurs par défaut s'appliquent quand un champ est omis.

ParamètreTypePar défautPlage / valeursDescription
imageimage--URL d’image de référence, URI de données ou objet image téléchargé.
resolutionenum1024512, 1024, 1536Résolution de la grille voxel. Les valeurs plus élevées sont plus lentes et plus détaillées.
pipeline_typeenum1024_cascade512, 1024_cascade, 1536_cascadePipeline TRELLIS explicite. Laissez sur la cascade 1024 sauf si vous avez besoin du chemin 512 ou 1536.
seedinteger420 à 2147483647Graine aléatoire pour des générations reproductibles.
preprocess_imagebooleantrue-Supprimez l’arrière-plan et normalisez l’image de référence avant la génération.
max_num_tokensinteger491521024 à 131072Maximum de jetons clairsemés utilisés pour la génération en cascade.
ss_sampling_stepsinteger121 à 64Étapes d’échantillonneur pour la génération de structures clairsemées.
ss_guidance_strengthnumber7.50 à 20Résistance au guidage pour la génération de structures clairsemées.
ss_guidance_rescalenumber0.70 à 2Redimensionnement des guides pour la génération de structures clairsemées.
ss_guidance_interval_startnumber0.60 à 1Début de l’intervalle de guidage à structure clairsemée.
ss_guidance_interval_endnumber10 à 1Fin de l’intervalle de guidage à structure clairsemée.
ss_rescale_tnumber50 à 20Redimensionnez la température pour une génération de structures clairsemées.
shape_slat_sampling_stepsinteger121 à 64Étapes d’échantillonneur pour la génération latente structurée par la forme.
shape_slat_guidance_strengthnumber7.50 à 20Résistance au guidage pour la génération latente structurée par la forme.
21 paramètres de plus dans la doc

Bon à savoir

Défauts - pipeline en cascade 1024 - 12 étapes d'échantillonnage par étape - taille de texture 2048 - cible de décimation 500k - sortie GLB Contrôles Prend en charge l'URL de l'image ou le téléchargement, la résolution 512/1024 /1536, le type de pipeline, l'échantillonneur guidance/interval /les contrôles de redimensionnement, la taille de la texture, la décimation du maillage, le remeshing, le réglage de déverrouillage UV et la sortie URL ou base64. La facturation est par actif 3D généré.

API TRELLIS.2 4B : questions fréquentes

Combien coûte l'API TRELLIS.2 4B ?

Sur EmpirioLabs, TRELLIS.2 4B est facturé à l'usage. La grille tarifaire en direct de cette page correspond toujours à ce que l'API facture.

Quel endpoint TRELLIS.2 4B utilise-t-il ?

TRELLIS.2 4B est servi via POST /v1/3d/generations sur api.empiriolabs.ai avec une authentification standard par token Bearer.

Puis-je essayer TRELLIS.2 4B dans le navigateur avant d'intégrer ?

Oui. Le playground EmpirioLabs exécute TRELLIS.2 4B dans le navigateur avec les mêmes paramètres que l'API expose, pour tester vos prompts avant d'écrire du code.

Comment obtenir une clé API TRELLIS.2 4B ?

Créez un compte EmpirioLabs, puis générez une clé sous API Keys dans le tableau de bord. La facturation utilise des crédits à l'usage : vous ne payez que vos requêtes.

Prêt à utiliser de meilleurs points de terminaison ?

Consultez nos tarifs ou contactez-nous si vous souhaitez que votre propre modèle soit déployé sur notre stack.