TRELLIS.2 イメージツー-3Dモデルで、リファレンスイメージを解像度、シード、メッシュ、テクスチャ、エクスポートコントロールでテクスチャーされたGLBアセットに変えます。
Microsoft3D生成ネイティブ推論TRELLIS.2 イメージツー-3Dモデルで、リファレンスイメージを解像度、シード、メッシュ、テクスチャ、エクスポートコントロールでテクスチャーされたGLBアセットに変えます。
別名 Microsoft TRELLIS.2 4B, TRELLIS.2-4B, trellis-2-4b
trellis-2-4b/v1/3d/generationsmicrosoft/trellis.2-4btrellis-2EmpirioLabs カタログのライブ従量課金料金です。使った分だけの支払いで、月額最低料金はありません。
TRELLIS.2 4B は POST /v1/3d/generations で動作します。リクエストはすぐに job_id を返すので、ジョブが完了するまで GET /v1/jobs/{job_id} をポーリングし、結果から出力 URL を読み取ってください。 EmpirioLabs ダッシュボードで API キーを取得してください。
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 https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"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)EmpirioLabs 上の TRELLIS.2 4B API が対応するリクエストパラメーターです。フィールドを省略した場合はデフォルト値が適用されます。
| パラメータ | タイプ | デフォルト | 範囲 / 値 | 説明 |
|---|---|---|---|---|
| image | image | - | - | 画像URL、データURI、またはアップロードされた画像オブジェクトを参照してください。 |
| resolution | enum | 1024 | 512, 1024, 1536 | ボクセルグリッド解像度。値が高いほど遅く、より詳細になります。 |
| pipeline_type | enum | 1024_cascade | 512, 1024_cascade, 1536_cascade | 明示的なTRELLISパイプライン。512や1536の道が必要でなければ、1024カスケードで出発してください。 |
| seed | integer | 42 | 0 から 2147483647 | 再現可能な世代のためのランダムシード。 |
| preprocess_image | boolean | true | - | 背景を除去し、生成前に参照画像を正規化します。 |
| max_num_tokens | integer | 49152 | 1024 から 131072 | カスケード生成に使われる最大スパーストークン。 |
| ss_sampling_steps | integer | 12 | 1 から 64 | スパース構造生成のためのサンプラーステップ。 |
| ss_guidance_strength | number | 7.5 | 0 から 20 | スパース構造生成のためのガイダンス強度。 |
| ss_guidance_rescale | number | 0.7 | 0 から 2 | スパース構造生成のためのガイダンス再スケール。 |
| ss_guidance_interval_start | number | 0.6 | 0 から 1 | 疎構造誘導間隔の開始。 |
| ss_guidance_interval_end | number | 1 | 0 から 1 | 疎構造誘導間隔の終了。 |
| ss_rescale_t | number | 5 | 0 から 20 | スパース構造生成のために温度を再スケーリングしてください。 |
| shape_slat_sampling_steps | integer | 12 | 1 から 64 | 形状構造的潜在生成のためのサンプラーステップ。 |
| shape_slat_guidance_strength | number | 7.5 | 0 から 20 | 形状構造的潜在生成のための誘導強度。 |
デフォルト - 1024のカスケードパイプライン - ステージごとの12のサンプラーステップ - 2048のテクスチャサイズ - 500kの決定ターゲット - GLB出力コントロール 画像 URL やアップロード、 512/1024 /1536 の解像度、シード、パイプラインタイプ、サンプラー guidance/interval /rescale の制御、テクスチャサイズ、メッシュの決定、リメッシュ、UV のアンラップチューニング、URL または base64 の出力をサポートします。 課金は生成された3Dアセットあたりです。
EmpirioLabs では TRELLIS.2 4B は従量課金です。このページのライブ料金表は常に API の請求額と一致します。
TRELLIS.2 4B は api.empiriolabs.ai 上の POST /v1/3d/generations で提供され、標準的な Bearer トークン認証を使用します。
はい。EmpirioLabs プレイグラウンドでは API と同じパラメーターで TRELLIS.2 4B をブラウザ上で実行できるので、コードを書く前にプロンプトを試せます。
EmpirioLabs アカウントを作成し、ダッシュボードの API Keysでキーを生成してください。課金は従量制クレジットなので、実行したリクエストの分だけ支払います。