3D
TripoSG 画像から 3D
1枚の写真を、ダウンロードできる 3D メッシュに変換。スマートフォンでも動作します。
TripoSG by VAST-AI-Research; DINOv2 by Meta AI; U2-Net by Xuebin Qin and contributors; rembg by Daniel Gatis
Real-ESRGAN by Xintao Wang
4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.
モデルのライセンス
TripoSG DiT and VAE ONNX derivatives · MIT
Preserve the complete MIT terms, copyright notice and disclaimer, and identify modifications. No upstream endorsement is granted.
DINOv2 Large conditioning image encoder · Apache-2.0
Preserve the complete Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.
U2-Net matte, rembg ONNX release · Apache-2.0 AND MIT
Preserve the complete applicable MIT/Apache-2.0 terms, copyright notices and disclaimers, identify modifications, and respect Apache patent/trademark provisions. No upstream endorsement is granted.
Real-ESRGAN x4plus original release ONNX derivative · BSD-3-Clause
Retain the original copyright notice, all three BSD conditions and warranty disclaimer with distributed copies. No endorsement using author/contributor names without permission.
Original 4x-UltraSharp ONNX conversion by Mesh · CC-BY-NC-SA-4.0
NonCommercial only. Preserve attribution, full license and modification notice. ShareAlike applies to adapted licensed material. Private compute only, unmetered, requester and operator acceptance required; no global-network execution. Acceptance does not grant commercial permission.
API リファレンス
REST で送信
個人用 API キー(msk_…)を使うと、ご自身のツールからこのワークロードのジョブを作成できます。この方法で開始したジョブは、あなたのデバイス で接続したのと同じデバイスで実行されます。少なくとも 1 台がオンラインである必要があります。
https://cp.meshlabs.cloud/v1/organizations/jobsX-Organization-Api-Key: msk_your_personal_api_key で認証します。ヘッダー名は組織キーと同じで、個人キーも同じエンドポイントを使用します。
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign を呼び出し、返された upload_url にファイルをアップロードしてから、job_spec に download_url を渡します(例:input_image_url として)。リクエストボディ
{
"workload_type": "triposg-1-5b-i2m",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
}
}job_spec のフィールド
| フィールド | 必須 | デフォルト | 説明 |
|---|---|---|---|
input_image_url | はい | — | 単一の物体の写真またはレンダリング。被写体は自動的に切り抜かれ、正方形にクロップされて 224x224 にリサイズされるため、はっきりした単一の被写体が最良のジオメトリを生みます。ごちゃごちゃしたシーンや複数の物体は、切り抜きを混乱させます。すでに透過のある PNG は切り抜きの手順を省略し、最も確実な入力です。 |
remove_background | いいえ | true | 画像に透過がない場合は、セグメンテーションモデルを実行します。すでに白背景できれいに切り抜かれた画像の場合や、被写体がフレームいっぱいの場合は、オフにしてください。 |
steps | いいえ | 50 | Rectified-flow のステップ数。約 16 を下回ると、形は認識できますが細かな起伏が失われ、既定値を超えると変化しなくなります。 |
guidance_scale | いいえ | 7 | メッシュが参照画像にどれだけ忠実に従うか。 |
seed | いいえ | — | 再現可能な生成のためのランダムシード。 |
grid_resolution | いいえ | 192 | 表面を抽出する場の解像度。コストは3乗で増えます。256 は既定値の約 2.4 倍の処理量で、その差は、ほとんどがスムージングで消えてしまいます。 |
texture | いいえ | true | 写真を、ベースカラーのテクスチャとしてメッシュに投影します。写真に写っていた側はくっきりと仕上がり、反対側は、1枚の画像では見えないため、最も近いシルエットの色がにじんだようになります。プレーンなグレーのメッシュにするにはオフにしてください。ファイルが小さくなり、ご自身でテクスチャを付ける場合に適した選択です。 |
texture_upscale | いいえ | false | 投影の前に、被写体に対して 4 倍の超解像パスを実行します。被写体がフレーム内で小さい場合にのみ効果があります。テクスチャは写真自身の解像度で作られるため、大きく鮮明な写真は、すでにそれが持つ以上のディテールを備えており、これは自前でダウンスケールしたものをアップスケールするだけになってしまいます。写真が十分に大きい場合は自動的に省略されるため、オンのままでもダウンロード以外のコストはかかりません。 |
texture_upscaler | いいえ | ultrasharp | UltraSharp: preferred detail, private NonCommercial use with terms acceptance. x4plus: BSD-3-Clause alternative. Used only when sharpening a small photo is enabled. |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "triposg-1-5b-i2m",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}status が終了状態(COMPLETED、FAILED、CANCELED、MODERATION_BLOCKED)になるまで、同じ API キーでポーリングします。コンテンツモデレーションが有効な場合、ジョブはコンピュートキューに入る前に MODERATION_PENDING から始まることがあります。完了したジョブには、各出力に署名済みの download_url の値が含まれます。
作成時のレスポンス
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "triposg-1-5b-i2m",
"status": "PENDING",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}完了時のレスポンス
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "triposg-1-5b-i2m",
"status": "COMPLETED",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"remove_background": true,
"steps": 50,
"guidance_scale": 7,
"grid_resolution": 192,
"texture": true,
"texture_upscale": false,
"texture_upscaler": "ultrasharp"
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}写真を1枚アップロードすると、3D メッシュ(GLB)をダウンロードできます。被写体は背景から切り抜かれます。色は写真から取られるため、撮影した側はくっきりしていて、反対側はやわらかくなり、メタリックやラフネスのマップはありません。スマートフォンを含め、接続したデバイスで無料の画像から 3D 生成。初回はモデルをダウンロードしますが、2枚目以降はより速く始まります。詳細オプションで、切り抜きとテクスチャをオフにしたり、被写体がフレーム内で小さすぎる場合に、より大きなテクスチャをオンにしたりできます。