Trellis 2

Integrasikan

ID model trellis-2

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/ms/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "trellis-2",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Panggil model Trellis 2 (trellis-2) melalui Doitong API. Dokumentasi untuk ejen: https://doitong.com/ms/developers/models/trellis-2.md

POST https://api.doitong.com/v1/run/trellis-2?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Jika status respons ialah "queued" atau "running", tinjau GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 sehingga statusnya menjadi "succeeded"; fail berada dalam outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 dengan badan yang sama mengembalikan harga tepat sebelum dijalankan.

Permintaan ini: $0.30 300 kredit API Jalankan pada halaman ini

Dapatkan kunci API

Microsoft Imej ke 3D #image-to-3d

Menukar satu imej kepada mesh 3D GLB bertekstur dengan tetapan struktur, bentuk, tekstur dan UV boleh laras

OpenAPI Markdown

Microsoft · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

image •diperlukan image_url

Lepaskan fail, atau

URL yang menunjuk kepada imej sumber untuk penukaran 3D.

resolution lalai 1024

Resolusi output; meningkatkannya menambah perincian tetapi mengambil masa lebih lama.

Lanjutan texture_size · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh

texture_size lalai 2048

Resolusi tekstur mesh untuk baking. Perincian permukaan yang lebih halus menghasilkan fail yang lebih besar apabila resolusi ini ditingkatkan.

ss_guidance_strength lalai 7.5

Kawalan kesetiaan struktur 3D awal: meningkatkannya mengutamakan keserupaan lebih dekat dengan imej input dengan risiko hingar tambahan.

ss_guidance_rescale lalai 0.7

Kawalan artifak panduan peringkat 1, yang menukar kesan panduan lebih kuat pada tetapan rendah dengan output lebih stabil pada tetapan tinggi.

ss_guidance_interval_start lalai 0.6

Sempadan permulaan tetingkap panduan tanpa pengelas pada peringkat 1 (struktur jarang), dinyatakan sebagai pecahan penyahhingaran. Tetapan lebih rendah memulakan panduan lebih awal; hanya selang daripada interval_start hingga interval_end menggunakan panduan.

ss_guidance_interval_end lalai 1

Had panduan untuk peringkat 1 (struktur jarang): pilih nilai sekurang-kurangnya sebesar ss_guidance_interval_start. Nilai ini mengenal pasti pecahan penyahhingaran apabila panduan tanpa pengelas berhenti.

ss_sampling_steps lalai 12

Bilangan penyahhingaran struktur awal: peningkatan kualiti berpotensi daripada langkah tambahan disertai pemprosesan yang lebih perlahan.

ss_rescale_t lalai 5

Tetapkan ketajaman peralihan melalui jadual hingar penjanaan struktur: meningkatkan nilai ini menjadikan peralihan lebih tajam.

shape_slat_guidance_strength lalai 7.5

Kawalan kesetiaan geometri terperinci: pematuhan yang lebih tinggi kepada imej input menghasilkan perincian tambahan, dengan risiko hingar tambahan.

shape_slat_guidance_rescale lalai 0.5

Tingkatkan tetapan ini apabila geometri kelihatan bising: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat bentuk.

shape_slat_guidance_interval_start lalai 0.6

Titik pengaktifan panduan tanpa pengelas untuk pemurnian bentuk pada peringkat 2. Dinyatakan sebagai pecahan kemajuan penyahhingaran, ia menetapkan interval_start; panduan hanya beroperasi dalam tetingkap antara interval_start dan interval_end.

shape_slat_guidance_interval_end lalai 1

Had panduan untuk peringkat 2 (pemurnian bentuk): pilih nilai sekurang-kurangnya sebesar shape_slat_guidance_interval_start. Nilai ini mengenal pasti pecahan penyahhingaran apabila panduan tanpa pengelas berhenti.

shape_slat_sampling_steps lalai 12

Bilangan penyahhingaran penapisan bentuk: geometri yang berpotensi lebih licin mengorbankan kelajuan apabila langkah tambahan digunakan.

shape_slat_rescale_t lalai 3

Tetapkan ketajaman perincian geometri melalui jadual hingar penapisan bentuk; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

tex_slat_guidance_strength lalai 1

Kawalan kesetiaan warna tekstur: pematuhan yang lebih dekat kepada warna dalam imej input pada tetapan lebih tinggi meningkatkan kecerahan tetapi boleh menyebabkan terlebih tepu.

tex_slat_guidance_rescale lalai 0

Tingkatkan tetapan ini untuk menangani tekstur bising atau jalur warna: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat tekstur.

tex_slat_guidance_interval_start lalai 0.6

Titik pengaktifan panduan tanpa pengelas untuk penjanaan tekstur pada peringkat 3. Dinyatakan sebagai pecahan kemajuan penyahhingaran, ia menetapkan interval_start; panduan hanya beroperasi dalam tetingkap antara interval_start dan interval_end.

tex_slat_guidance_interval_end lalai 0.9

Had panduan untuk peringkat 3 (tekstur): pilih nilai sekurang-kurangnya sebesar tex_slat_guidance_interval_start. Nilai ini mengenal pasti pecahan penyahhingaran apabila panduan tanpa pengelas berhenti.

tex_slat_sampling_steps lalai 12

Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur. Meningkatkan bilangan langkah mengambil masa lebih lama tetapi mungkin menghasilkan tekstur yang lebih bersih.

tex_slat_rescale_t lalai 3

Tetapkan ketajaman perincian tekstur melalui jadual hingar penjanaan tekstur; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

decimation_target lalai 500000

Sasaran bilangan bucu mesh, dengan 500k disyorkan untuk kegunaan umum dan 20k–50k untuk web/mudah alih. Mengurangkan sasaran menukar perincian mesh kepada fail lebih kecil.

remesh_band lalai 1

Kebenaran pergerakan pembentukan semula mesh: pelicinan tambahan mungkin mengorbankan perincian halus apabila nilai ini ditingkatkan. Tetapan mengehadkan anjakan bucu berbanding permukaan asal.

remesh_project lalai 0

Kekuatan unjuran untuk mengembalikan bucu yang dibentuk semula ke permukaan asal: 1 mengekalkan perincian melalui unjuran penuh, manakala 0 mematikan unjuran untuk hasil lebih licin.

uv_unwrap_angle_threshold_deg lalai 90

Had sudut carta UV dalam darjah, mengehadkan perbezaan normal muka bersebelahan dalam satu carta. Nilai lebih tinggi memilih carta lebih sedikit dan besar dengan risiko regangan; nilai lebih rendah memilih lebih banyak carta dan kurang herotan.

uv_unwrap_refine_iterations lalai 0

Bilangan laluan pemurnian setempat yang digunakan untuk mengira carta UV.

uv_unwrap_global_iterations lalai 1

Keseimbangan carta UV boleh ditambah baik dengan meningkatkan bilangan laluan pengelompokan global yang digunakan untuk mengira carta.

uv_unwrap_smooth_strength lalai 1

Laraskan kekuatan pelicinan tepi carta UV; jahitan kurang kelihatan pada tetapan lebih tinggi, tetapi berisiko menyebabkan herotan UV.

seed

Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.

POST /run/trellis-2?wait=20 sebut harga → $0.30

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "trellis-2",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

Jalankan permintaan ini

Kunci API

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Ingat dalam pelayar ini Dapatkan kunci API

Tentang Trellis 2

Membina aset 3D daripada satu imej (`image_url`) dan mengembalikan fail GLB. `resolution` ialah 512, 1024 atau 1536, manakala `texture_size` ialah 1024, 2048 atau 4096. Setiap daripada tiga peringkat (struktur, bentuk, tekstur) mempunyai kawalan panduan dan langkah pensampelan tersendiri. `decimation_target` menetapkan bilangan bucu jejaring (5,000 hingga 2,000,000), dan pilihan pemjejaringan semula serta pembukaan UV didedahkan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan

seedpilihan

Jenisinteger | null

Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.

resolutionpilihan

Jenisenum

Lalai1024

51210241536

Resolusi output; meningkatkannya menambah perincian tetapi mengambil masa lebih lama.

ss_guidance_strengthpilihan

Jenisnumber

Lalai7.5

0 – 10

Kawalan kesetiaan struktur 3D awal: meningkatkannya mengutamakan keserupaan lebih dekat dengan imej input dengan risiko hingar tambahan.

ss_guidance_rescalepilihan

Jenisnumber

Lalai0.7

0 – 1

Kawalan artifak panduan peringkat 1, yang menukar kesan panduan lebih kuat pada tetapan rendah dengan output lebih stabil pada tetapan tinggi.

ss_guidance_interval_startpilihan

Jenisnumber

Lalai0.6

0 – 1

ss_guidance_interval_endpilihan

Jenisnumber

Lalai1

0 – 1

ss_sampling_stepspilihan

Jenisinteger

Lalai12

1 – 50

Bilangan penyahhingaran struktur awal: peningkatan kualiti berpotensi daripada langkah tambahan disertai pemprosesan yang lebih perlahan.

ss_rescale_tpilihan

Jenisnumber

Lalai5

1 – 6

Tetapkan ketajaman peralihan melalui jadual hingar penjanaan struktur: meningkatkan nilai ini menjadikan peralihan lebih tajam.

shape_slat_guidance_strengthpilihan

Jenisnumber

Lalai7.5

0 – 10

Kawalan kesetiaan geometri terperinci: pematuhan yang lebih tinggi kepada imej input menghasilkan perincian tambahan, dengan risiko hingar tambahan.

shape_slat_guidance_rescalepilihan

Jenisnumber

Lalai0.5

0 – 1

Tingkatkan tetapan ini apabila geometri kelihatan bising: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat bentuk.

shape_slat_guidance_interval_startpilihan

Jenisnumber

Lalai0.6

0 – 1

shape_slat_guidance_interval_endpilihan

Jenisnumber

Lalai1

0 – 1

shape_slat_sampling_stepspilihan

Jenisinteger

Lalai12

1 – 50

Bilangan penyahhingaran penapisan bentuk: geometri yang berpotensi lebih licin mengorbankan kelajuan apabila langkah tambahan digunakan.

shape_slat_rescale_tpilihan

Jenisnumber

Lalai3

1 – 6

Tetapkan ketajaman perincian geometri melalui jadual hingar penapisan bentuk; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

tex_slat_guidance_strengthpilihan

Jenisnumber

Lalai1

0 – 10

Kawalan kesetiaan warna tekstur: pematuhan yang lebih dekat kepada warna dalam imej input pada tetapan lebih tinggi meningkatkan kecerahan tetapi boleh menyebabkan terlebih tepu.

tex_slat_guidance_rescalepilihan

Jenisnumber

Lalai0

0 – 1

Tingkatkan tetapan ini untuk menangani tekstur bising atau jalur warna: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat tekstur.

tex_slat_guidance_interval_startpilihan

Jenisnumber

Lalai0.6

0 – 1

tex_slat_guidance_interval_endpilihan

Jenisnumber

Lalai0.9

0 – 1

tex_slat_sampling_stepspilihan

Jenisinteger

Lalai12

1 – 50

Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur. Meningkatkan bilangan langkah mengambil masa lebih lama tetapi mungkin menghasilkan tekstur yang lebih bersih.

tex_slat_rescale_tpilihan

Jenisnumber

Lalai3

1 – 6

Tetapkan ketajaman perincian tekstur melalui jadual hingar penjanaan tekstur; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

decimation_targetpilihan

Jenisinteger

Lalai500000

5,000 – 2,000,000

Sasaran bilangan bucu mesh, dengan 500k disyorkan untuk kegunaan umum dan 20k–50k untuk web/mudah alih. Mengurangkan sasaran menukar perincian mesh kepada fail lebih kecil.

texture_sizepilihan

Jenisenum

Lalai2048

102420484096

Resolusi tekstur mesh untuk baking. Perincian permukaan yang lebih halus menghasilkan fail yang lebih besar apabila resolusi ini ditingkatkan.

remeshpilihan

Jenisboolean

Lalaitrue

Pembinaan semula topologi yang menghasilkan segi tiga mesh lebih bersih, biasanya meningkatkan kesesuaian untuk kegunaan seterusnya seperti animasi atau pencetakan 3D, dengan kos pemprosesan lebih lama.

remesh_bandpilihan

Jenisnumber

Lalai1

0 – 4

Kebenaran pergerakan pembentukan semula mesh: pelicinan tambahan mungkin mengorbankan perincian halus apabila nilai ini ditingkatkan. Tetapan mengehadkan anjakan bucu berbanding permukaan asal.

remesh_projectpilihan

Jenisnumber

Lalai0

0 – 1

Kekuatan unjuran untuk mengembalikan bucu yang dibentuk semula ke permukaan asal: 1 mengekalkan perincian melalui unjuran penuh, manakala 0 mematikan unjuran untuk hasil lebih licin.

uv_unwrap_angle_threshold_degpilihan

Jenisnumber

Lalai90

0 – 180

uv_unwrap_refine_iterationspilihan

Jenisinteger

Lalai0

0 – 10

Bilangan laluan pemurnian setempat yang digunakan untuk mengira carta UV.

uv_unwrap_global_iterationspilihan

Jenisinteger

Lalai1

1 – 10

Keseimbangan carta UV boleh ditambah baik dengan meningkatkan bilangan laluan pengelompokan global yang digunakan untuk mengira carta.

uv_unwrap_smooth_strengthpilihan

Jenisnumber

Lalai1

0 – 10

Laraskan kekuatan pelicinan tepi carta UV; jahitan kurang kelihatan pada tetapan lebih tinggi, tetapi berisiko menyebabkan herotan UV.

image_urldiperlukan image

Jenisurl · image

URL yang menunjuk kepada imej sumber untuk penukaran 3D.

diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.

Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.

Medan output

model_glb: object {url, content_type, file_name, file_size}Model 3D yang dijana dalam format GLB.

Lebih banyak model: Imej ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/trellis-2.md. Semua model dan panduan: https://doitong.com/developers/llms.txt

Hasil pertama anda akan muncul di sini

Bina permintaan

Jalankan permintaan ini

Tentang Trellis 2

Parameter

Output

Varian Trellis 2 lain

Trellis 2 · Retexture Varian: 2

Lebih banyak model: Imej ke 3D

Trellis Varian: 2

Trellis · Multi Varian: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Varian: 6