TRELLIS.2 4B | EmpirioLabs AI Docs

Microsoft · 3D Generation

POST /v1/3d/generations

TRELLIS.2 イメージから3Dへのモデルで、参照画像を解像度、シード、メッシュ、テクスチャ、エクスポートコントロールを備えたテクスチャ付きGLBアセットに変換します。

一目で

フィールド	価値
モデルID	`trellis-2-4b`
モデル発売日	-
入力モダリティ	画像
出力モダリティ	3D
コンテキストウィンドウ	-
重量精度	混合BF16/FP16
特徴	image_to_3d、glb_output、pbr_materials、seed_control、commercial_ready
ネイティブ推論	はい
新作	はい
サポート端末	`POST /v1/3d/generations`

価格設定

チャージ	スペック	レート
512資産	リクエストごとに	$0.025(だった$0.25)
1024アセット	リクエストごとに	$0.249(だった$0.30)
1536年資産	リクエストごとに	$0.499

例示リクエスト

$ 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"}'

パラメータ

パラメータ	種類	必須	デフォルト	概要
`image`	画像	はい	-	画像URL、データURI、またはアップロードされた画像オブジェクトを参照してください。
`resolution`	エヌム	いいえ	`"1024"`	ボクセルグリッド解像度。値が高いほど遅く、より詳細になります。·許可:`512`、`1024`、`1536`
`pipeline_type`	エヌム	いいえ	`"1024_cascade"`	明示的なTRELLISパイプライン。512や1536の道が必要でなければ、1024カスケードで出発してください。·許可:`512`、`1024_cascade`、`1536_cascade`
`seed`	整数	いいえ	`42`	再現可能な世代のためのランダムシード。·射程:0 – 2147483647
`preprocess_image`	ブール値	いいえ	確かに	背景を除去し、生成前に参照画像を正規化します。
`max_num_tokens`	整数	いいえ	`49152`	カスケード生成に使われる最大スパーストークン。·射程:1024 – 131072
`ss_sampling_steps`	整数	いいえ	`12`	スパース構造生成のためのサンプラーステップ。·射程:1 – 64
`ss_guidance_strength`	番号	いいえ	`7.5`	スパース構造生成のためのガイダンス強度。·範囲:0 – 20
`ss_guidance_rescale`	番号	いいえ	`0.7`	スパース構造生成のためのガイダンス再スケール。·射程:0 – 2
`ss_guidance_interval_start`	番号	いいえ	`0.6`	疎構造誘導間隔の開始。·射程:0 – 1
`ss_guidance_interval_end`	番号	いいえ	`1`	疎構造誘導間隔の終了。·射程:0 – 1
`ss_rescale_t`	番号	いいえ	`5`	スパース構造生成のために温度を再スケーリングしてください。·範囲:0 – 20
`shape_slat_sampling_steps`	整数	いいえ	`12`	形状構造的潜在生成のためのサンプラーステップ。·射程:1 – 64
`shape_slat_guidance_strength`	番号	いいえ	`7.5`	形状構造的潜在生成のための誘導強度。·範囲:0 – 20
`shape_slat_guidance_rescale`	番号	いいえ	`0.5`	形状構造的潜在生成のためのガイダンス再スケール。·射程:0 – 2
`shape_slat_guidance_interval_start`	番号	いいえ	`0.6`	形状の開始 SLat 誘導間隔。·射程:0 – 1
`shape_slat_guidance_interval_end`	番号	いいえ	`1`	形状の終わり SLatの誘導間隔。·射程:0 – 1
`shape_slat_rescale_t`	番号	いいえ	`3`	形状構造的潜在生成のために温度を再スケーリングします。·範囲:0 – 20
`tex_slat_sampling_steps`	整数	いいえ	`12`	テクスチャ構造化潜在生成のためのサンプラーステップ。·射程:1 – 64
`tex_slat_guidance_strength`	番号	いいえ	`1`	テクスチャー構造的潜在生成のためのガイダンス強度。·範囲:0 – 20
`tex_slat_guidance_rescale`	番号	いいえ	`0`	テクスチャ構造化潜在生成のためのガイダンス再スケール。·射程:0 – 2
`tex_slat_guidance_interval_start`	番号	いいえ	`0.6`	テクスチャSLatのガイダンス間隔の開始。·射程:0 – 1
`tex_slat_guidance_interval_end`	番号	いいえ	`0.9`	テクスチャSLatのガイダンス間隔の終わり。·射程:0 – 1
`tex_slat_rescale_t`	番号	いいえ	`3`	テクスチャの構造的潜在生成のための温度の再スケーリング。·範囲:0 – 20
`texture_size`	エヌム	いいえ	`"2048"`	テクスチャ解像度がGLBマテリアルにベイクされました。·許可:`1024`、`2048`、`4096`
`decimation_target`	整数	いいえ	`500000`	エクスポートしたメッシュのおおよそのターゲット頂点数。·射程:10000 – 10000000
`remesh`	ブール値	いいえ	確かに	UVアンラップとテクスチャベイクの前にメッシュトポロジーを再構築します。
`remesh_band`	番号	いいえ	`1`	バンドサイズの再メッシュ調整。·射程:0 – 5
`remesh_project`	番号	いいえ	`0.9`	リメッシュ時に使用した投影係数。·射程:0 – 1
`uv_unwrap_angle_threshold_deg`	番号	いいえ	`90`	UVアンラップクラスタリングに使われるコーン半角しきい値。·範囲:1 – 180
`uv_unwrap_refine_iterations`	整数	いいえ	`0`	UVクラスタリングの洗練反復。·範囲:0 – 10
`uv_unwrap_global_iterations`	整数	いいえ	`1`	グローバルUVクラスタリングの反復。·範囲:0 – 10
`uv_unwrap_smooth_strength`	番号	いいえ	`1`	UVクラスター平滑化強度。·範囲:0 – 10
`response_format`	エヌム	いいえ	`"url"`	デフォルトで署名済みのメディアURLを返すか、リクエストがあればインラインのbase64 JSONを返してください。·許可:`url`、`b64_json`
`verbose`	ブール値	いいえ	偽り	詳細メッシュのエクスポートログを有効にしてください。

注記

デフォルト

1024カスケードパイプライン
各ステージにつき12ステップのサンプラー
2048テクスチャサイズ
50万の壊滅目標
GLB出力

操作系統

画像URLまたはアップロード、512/1024/1536解像度、シード、パイプラインタイプ、サンプラーguidance/interval/リスケールコントロール、テクスチャサイズ、メッシュデシメーション、リメッシュ、UVアンラップ調整、URLまたはbase64出力をサポートしています。請求は生成された3Dアセットごとに計算されます。

Machine-readable schema: GET https://api.empiriolabs.ai/v1/models/trellis-2-4b。