Op den Inhalt sprangen

Trellis 2

Integréieren

Modell-ID 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"

Dës Ufro: 0,30 $ 300 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Microsoft Bild zu 3D #image-to-3d

Maacht aus engem eenzege Bild en texturéierten GLB-3D-Mesh mat justéierbare Struktur-, Form-, Textur- an UV-Astellungen

Microsoft · 3D

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch image_url
Fichier erofzéien, oder

URL op d'Quellbild fir d'3D-Konversioun.

resolution Standard 1024

Opléisung vum Output; eng Erhéijung füügt Detailer bäi, dauert awer méi laang.

Erweidert 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 Standard 2048

Textur-Opléisung vum Mesh fir d'Baken. Méi fein Uewerflächendetailer féieren zu méi groussen Dateien, wann dës Opléisung erhéicht gëtt.

Standard 7.5

Fidelitéitskontroll vun der initialer 3D-Struktur: eng Erhéijung favoriséiert eng méi grouss Iwwereneestëmmung mam Input-Bild, mat Risiko fir zousätzlecht Rauschen.

Standard 0.7

Kontroll vun de Leedungsartefaktere vun der éischter Phas: niddreg Astellunge stäerken d'Leedungseffekter, héich Astellunge féieren zu engem méi stabile Output.

Standard 0.6

Ufanksgrenz vun der classifier-free-Guidance-Fënster an der Etapp 1 (sparse Struktur), als Denoising-Fraktioun. Méi niddreg Astellunge starten d'Guidance éischter; nëmmen den Intervall vun interval_start bis interval_end benotzt Guidance, soss leeft d'Veraarbechtung ouni Guidance.

Standard 1

Guidance-Limit fir Etapp 1 (sparse Struktur): wielt e Wäert op d'mannst esou grouss wéi ss_guidance_interval_start. De Wäert identifizéiert d'Fraktioun vum Denoising, bei där classifier-free Guidance ophält.

Standard 12

Denoising-Zuel vun der initialer Struktur: méiglech Qualitéitsgewënn duerch zousätzlech Schrëtt féieren zu méi lueser Beaarbechtung.

Standard 5

Setzt d'Schäerft vum Iwwergang iwwer de Rauschplang vun der Strukturgeneratioun; eng Erhéijung mécht d'Iwwergäng méi schaarf.

Standard 7.5

Fidelitéitskontroll vun der detailléierter Geometrie: méi staark Unhale vum Input-Bild liwwert zousätzlech Detailer, mat Risiko fir méi Rauschen.

Standard 0.5

Erhéicht dës Astellung, wann d'Geometrie rauschëg ausgesäit: si reduzéiert Artefakter duerch staark Leedung an der Formphas.

Standard 0.6

Aktivéierungspunkt vun der classifier-free Guidance fir d'Formverfeinerung an Etapp 2. Als Fraktioun vum Denoising-Fortschrëtt setzt en interval_start; Guidance funktionéiert nëmmen an der Fënster tëscht interval_start an interval_end.

Standard 1

Guidance-Limit fir Etapp 2 (Formverfeinerung): wielt e Wäert op d'mannst esou grouss wéi shape_slat_guidance_interval_start. De Wäert identifizéiert d'Fraktioun vum Denoising, bei där classifier-free Guidance ophält.

Standard 12

Denoising-Zuel vun der Formverfeinerung: zousätzlech Schrëtt kënne méi glat Geometrie liwweren, op Käschte vun der Geschwindegkeet.

Standard 3

Setzt d'Schäerft vun de geometreschen Detailer iwwer de Rauschplang vun der Formverfeinerung; eng Erhéijung liwwert méi schaarf Detailer.

Standard 1

Fidelitéitskontroll vun den Texturfaarwen: méi staarkt Unhale vun de Faarwen am Input-Bild bei héijen Astellunge mécht d'Faarwe méi lieweg, kann awer zu Iwwersaturatioun féieren.

Standard 0

Erhéicht dës Astellung bei rauschëgen Texturen oder Faarwebännerungen: si reduzéiert Artefakter duerch staark Leedung an der Texturphas.

Standard 0.6

Aktivéierungspunkt vun der classifier-free Guidance fir d'Textur-Generatioun an Etapp 3. Als Fraktioun vum Denoising-Fortschrëtt setzt en interval_start; Guidance funktionéiert nëmmen an der Fënster tëscht interval_start an interval_end.

Standard 0.9

Guidance-Limit fir Etapp 3 (Textur): wielt e Wäert op d'mannst esou grouss wéi tex_slat_guidance_interval_start. De Wäert identifizéiert d'Fraktioun vum Denoising, bei där classifier-free Guidance ophält.

Standard 12

Zuel vun den Denoising-Schrëtt fir d'Texturgeneratioun. Eng Erhéijung dauert méi laang, kann awer méi propper Texturen erginn.

Standard 3

Setzt d'Schäerft vun den Texturdetailer iwwer de Rauschplang vun der Texturgeneratioun; eng Erhéijung liwwert méi schaarf Detailer.

Standard 500000

Zilzuel vun de Mesh-Vertexen; 500k gëtt fir allgemeng Notzung recommandéiert, 20k–50k fir Web/Mobile. Eng Reduktioun tauscht Mesh-Detailer géint méi kleng Dateien.

Standard 1

Beweegungsspielraum beim Remeshing: Méi Glättung kann fein Detailer opferen, wann dëse Wäert erhéicht gëtt. D'Astellung limitéiert d'Vertex-Verschiebung par rapport zu der Originalsfläch.

Standard 0

Projektéierungsstäerkt fir remeshed Vertexen op d'Originalfläch zeréckzeféieren: 1 erhält Detailer duerch vollstänneg Projektioun, 0 schalt d'Projektioun aus a liwwert e méi glat Resultat.

Standard 90

UV-Chart-Wénkellimit a Grad, déi limitéiert, wéi staark sech benachbart Flächennormalen an engem Chart ënnerscheede kënnen. Eng Erhéijung favoriséiert manner, méi grouss Charts mat dem Risiko vu Verzerrung; eng Reduktioun favoriséiert méi Charts a manner Verzerrung.

Standard 0

Zuel vun de lokalen Verfeinerungsduerchleef fir d'Berechnung vun UV-Charts.

Standard 1

D'Saldo vun den UV-Charts kann duerch eng Erhéijung vun dëser Zuel vu globale Clustering-Duerchleef verbessert ginn.

Standard 1

Passt un, wéi staark d'Kante vun UV-Charts geglätt ginn; manner siichtbar Näh bei méi héijen Astellunge bréngen de Risiko vun UV-Verzerrung mat sech.

Seed fir reproduzéierbar zoufälleg Generatioun.

POST /run/trellis-2?wait=20 Präis → 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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Trellis 2

Baut aus engem Bild (`image_url`) en 3D-Asset a gëtt eng GLB-Datei zeréck. `resolution` ass 512, 1024 oder 1536, an `texture_size` ass 1024, 2048 oder 4096. Jiddwer vun den dräi Etappen (Struktur, Form, Textur) huet separat Guidance- a Sampling-Schrëtt-Kontrollen. `decimation_target` setzt d'Zuel vun de Mesh-Vertices (5,000 bis 2,000,000); Optioune fir Remeshing an UV-Unwrapping si verfügbar.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
seedoptional
Typinteger | null
Seed fir reproduzéierbar zoufälleg Generatioun.
resolutionoptional
Typenum
Standard1024
51210241536
Opléisung vum Output; eng Erhéijung füügt Detailer bäi, dauert awer méi laang.
ss_guidance_strengthoptional
Typnumber
Standard7.5
0 – 10
Fidelitéitskontroll vun der initialer 3D-Struktur: eng Erhéijung favoriséiert eng méi grouss Iwwereneestëmmung mam Input-Bild, mat Risiko fir zousätzlecht Rauschen.
ss_guidance_rescaleoptional
Typnumber
Standard0.7
0 – 1
Kontroll vun de Leedungsartefaktere vun der éischter Phas: niddreg Astellunge stäerken d'Leedungseffekter, héich Astellunge féieren zu engem méi stabile Output.
ss_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Ufanksgrenz vun der classifier-free-Guidance-Fënster an der Etapp 1 (sparse Struktur), als Denoising-Fraktioun. Méi niddreg Astellunge starten d'Guidance éischter; nëmmen den Intervall vun interval_start bis interval_end benotzt Guidance, soss leeft d'Veraarbechtung ouni Guidance.
ss_guidance_interval_endoptional
Typnumber
Standard1
0 – 1
Guidance-Limit fir Etapp 1 (sparse Struktur): wielt e Wäert op d'mannst esou grouss wéi ss_guidance_interval_start. De Wäert identifizéiert d'Fraktioun vum Denoising, bei där classifier-free Guidance ophält.
ss_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Denoising-Zuel vun der initialer Struktur: méiglech Qualitéitsgewënn duerch zousätzlech Schrëtt féieren zu méi lueser Beaarbechtung.
ss_rescale_toptional
Typnumber
Standard5
1 – 6
Setzt d'Schäerft vum Iwwergang iwwer de Rauschplang vun der Strukturgeneratioun; eng Erhéijung mécht d'Iwwergäng méi schaarf.
shape_slat_guidance_strengthoptional
Typnumber
Standard7.5
0 – 10
Fidelitéitskontroll vun der detailléierter Geometrie: méi staark Unhale vum Input-Bild liwwert zousätzlech Detailer, mat Risiko fir méi Rauschen.
shape_slat_guidance_rescaleoptional
Typnumber
Standard0.5
0 – 1
Erhéicht dës Astellung, wann d'Geometrie rauschëg ausgesäit: si reduzéiert Artefakter duerch staark Leedung an der Formphas.
shape_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Aktivéierungspunkt vun der classifier-free Guidance fir d'Formverfeinerung an Etapp 2. Als Fraktioun vum Denoising-Fortschrëtt setzt en interval_start; Guidance funktionéiert nëmmen an der Fënster tëscht interval_start an interval_end.
shape_slat_guidance_interval_endoptional
Typnumber
Standard1
0 – 1
Guidance-Limit fir Etapp 2 (Formverfeinerung): wielt e Wäert op d'mannst esou grouss wéi shape_slat_guidance_interval_start. De Wäert identifizéiert d'Fraktioun vum Denoising, bei där classifier-free Guidance ophält.
shape_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Denoising-Zuel vun der Formverfeinerung: zousätzlech Schrëtt kënne méi glat Geometrie liwweren, op Käschte vun der Geschwindegkeet.
shape_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Setzt d'Schäerft vun de geometreschen Detailer iwwer de Rauschplang vun der Formverfeinerung; eng Erhéijung liwwert méi schaarf Detailer.
tex_slat_guidance_strengthoptional
Typnumber
Standard1
0 – 10
Fidelitéitskontroll vun den Texturfaarwen: méi staarkt Unhale vun de Faarwen am Input-Bild bei héijen Astellunge mécht d'Faarwe méi lieweg, kann awer zu Iwwersaturatioun féieren.
tex_slat_guidance_rescaleoptional
Typnumber
Standard0
0 – 1
Erhéicht dës Astellung bei rauschëgen Texturen oder Faarwebännerungen: si reduzéiert Artefakter duerch staark Leedung an der Texturphas.
tex_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Aktivéierungspunkt vun der classifier-free Guidance fir d'Textur-Generatioun an Etapp 3. Als Fraktioun vum Denoising-Fortschrëtt setzt en interval_start; Guidance funktionéiert nëmmen an der Fënster tëscht interval_start an interval_end.
tex_slat_guidance_interval_endoptional
Typnumber
Standard0.9
0 – 1
Guidance-Limit fir Etapp 3 (Textur): wielt e Wäert op d'mannst esou grouss wéi tex_slat_guidance_interval_start. De Wäert identifizéiert d'Fraktioun vum Denoising, bei där classifier-free Guidance ophält.
tex_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Zuel vun den Denoising-Schrëtt fir d'Texturgeneratioun. Eng Erhéijung dauert méi laang, kann awer méi propper Texturen erginn.
tex_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Setzt d'Schäerft vun den Texturdetailer iwwer de Rauschplang vun der Texturgeneratioun; eng Erhéijung liwwert méi schaarf Detailer.
decimation_targetoptional
Typinteger
Standard500000
5.000 – 2.000.000
Zilzuel vun de Mesh-Vertexen; 500k gëtt fir allgemeng Notzung recommandéiert, 20k–50k fir Web/Mobile. Eng Reduktioun tauscht Mesh-Detailer géint méi kleng Dateien.
texture_sizeoptional
Typenum
Standard2048
102420484096
Textur-Opléisung vum Mesh fir d'Baken. Méi fein Uewerflächendetailer féieren zu méi groussen Dateien, wann dës Opléisung erhéicht gëtt.
remeshoptional
Typboolean
Standardtrue
Neiopbau vun der Topologie, deen méi propper Mesh-Dreiecke schaaft an dacks d'Eegnung fir spéider Notzunge wéi Animatioun oder 3D-Dréck verbessere kann, awer d'Veraarbechtung verlangsamt.
remesh_bandoptional
Typnumber
Standard1
0 – 4
Beweegungsspielraum beim Remeshing: Méi Glättung kann fein Detailer opferen, wann dëse Wäert erhéicht gëtt. D'Astellung limitéiert d'Vertex-Verschiebung par rapport zu der Originalsfläch.
remesh_projectoptional
Typnumber
Standard0
0 – 1
Projektéierungsstäerkt fir remeshed Vertexen op d'Originalfläch zeréckzeféieren: 1 erhält Detailer duerch vollstänneg Projektioun, 0 schalt d'Projektioun aus a liwwert e méi glat Resultat.
uv_unwrap_angle_threshold_degoptional
Typnumber
Standard90
0 – 180
UV-Chart-Wénkellimit a Grad, déi limitéiert, wéi staark sech benachbart Flächennormalen an engem Chart ënnerscheede kënnen. Eng Erhéijung favoriséiert manner, méi grouss Charts mat dem Risiko vu Verzerrung; eng Reduktioun favoriséiert méi Charts a manner Verzerrung.
uv_unwrap_refine_iterationsoptional
Typinteger
Standard0
0 – 10
Zuel vun de lokalen Verfeinerungsduerchleef fir d'Berechnung vun UV-Charts.
uv_unwrap_global_iterationsoptional
Typinteger
Standard1
1 – 10
D'Saldo vun den UV-Charts kann duerch eng Erhéijung vun dëser Zuel vu globale Clustering-Duerchleef verbessert ginn.
uv_unwrap_smooth_strengthoptional
Typnumber
Standard1
0 – 10
Passt un, wéi staark d'Kante vun UV-Charts geglätt ginn; manner siichtbar Näh bei méi héijen Astellunge bréngen de Risiko vun UV-Verzerrung mat sech.
image_urlobligatoresch image
Typurl · image
URL op d'Quellbild fir d'3D-Konversioun.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
model_glb
object {url, content_type, file_name, file_size}3D-Modell am GLB-Format, dat generéiert gouf.

Méi Modeller: Bild zu 3D

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/trellis-2.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt