Gå til innhold

Trellis 2

Integrer

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"

Denne forespørselen: 0,30 $ 300 API-kreditter Kjør den på denne siden

Hent API-nøkkel
Microsoft Bilde til 3D #image-to-3d

Gjør ett bilde om til et teksturert GLB 3D-nett med justerbare innstillinger for struktur, form, tekstur og UV

Microsoft · 3D

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

•obligatorisk image_url
Slipp en fil, eller

URL som peker til kildebildet for 3D-konvertering.

resolution standard 1024

Oppløsning for utdata; høyere oppløsning gir flere detaljer, men tar lengre tid.

Avansert 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

Teksturoppløsning for baking av mesh. Finere overflatedetaljer gir større filer når oppløsningen økes.

standard 7.5

Kontroll for troskap mot den innledende 3D-strukturen: høyere verdi favoriserer bedre samsvar med inndatabildet, med risiko for mer støy.

standard 0.7

Kontroll for veiledningsartefakter i trinn 1, der lave innstillinger gir sterkere veiledningseffekter og høye innstillinger gir mer stabile utdata.

standard 0.6

Startgrense for classifier-free guidance-vinduet i trinn 1 (sparse structure), uttrykt som en denoising-brøk. Lavere innstillinger starter veiledningen tidligere; bare intervallet fra interval_start til interval_end bruker veiledning, mens behandlingen ellers skjer uten veiledning.

standard 1

Veiledningsgrense for trinn 1 (sparse structure): velg en verdi som er minst like stor som ss_guidance_interval_start. Verdien angir brøken av denoising-fremdriften der classifier-free guidance stopper.

standard 12

Antall støyfjerningssteg for den innledende strukturen: mulige kvalitetsforbedringer fra flere steg gir langsommere behandling.

standard 5

Angi overgangsskarphet gjennom støyskjemaet for strukturgenerering: høyere verdi gjør overgangene skarpere.

standard 7.5

Kontroll for troskap mot detaljert geometri: høyere samsvar med inndatabildet gir flere detaljer, med risiko for mer støy.

standard 0.5

Øk denne innstillingen når geometrien ser støyete ut: den reduserer artefakter forårsaket av sterk veiledning under formtrinnet.

standard 0.6

Aktiveringspunkt for classifier-free guidance ved formforbedring i trinn 2. Uttrykt som en brøk av denoising-fremdriften angir den interval_start; veiledningen brukes bare i vinduet avgrenset av interval_start og interval_end.

standard 1

Veiledningsgrense for trinn 2 (shape refinement): velg en verdi som er minst like stor som shape_slat_guidance_interval_start. Verdien angir brøken av denoising-fremdriften der classifier-free guidance stopper.

standard 12

Antall støyfjerningssteg for formforbedring: jevnere geometri kan oppnås på bekostning av hastighet når flere steg brukes.

standard 3

Angi skarpheten for geometriske detaljer gjennom støyskjemaet for formforbedring; høyere verdi gir skarpere detaljer.

standard 1

Kontroll for fargetroskap i teksturen: bedre samsvar med fargene i inndatabildet ved høyere innstillinger øker intensiteten, men kan gi overmetning.

standard 0

Øk denne innstillingen for å håndtere støyete teksturer eller fargebånd: den reduserer artefakter forårsaket av sterk veiledning under teksturtrinnet.

standard 0.6

Aktiveringspunkt for classifier-free guidance ved teksturgenerering i trinn 3. Uttrykt som en brøk av denoising-fremdriften angir den interval_start; veiledningen brukes bare i vinduet avgrenset av interval_start og interval_end.

standard 0.9

Veiledningsgrense for trinn 3 (texture): velg en verdi som er minst like stor som tex_slat_guidance_interval_start. Verdien angir brøken av denoising-fremdriften der classifier-free guidance stopper.

standard 12

Antall støyfjerningssteg brukt til å generere teksturer. Flere steg tar lengre tid, men kan gi renere teksturer.

standard 3

Angi skarpheten for teksturdetaljer gjennom støyskjemaet for teksturgenerering; høyere verdi gir skarpere detaljer.

standard 500000

Mål for antall mesh-vertices, med 500k anbefalt til generell bruk og 20k–50k for web/mobil. En reduksjon av målet bytter meshdetaljer mot mindre filer.

standard 1

Bevegelsesmargin for remeshing: ekstra utjevning kan ofre fine detaljer når denne verdien økes. Innstillingen begrenser vertex-forskyvningen i forhold til den opprinnelige overflaten.

standard 0

Projeksjonsstyrke for å føre remesh-vertices tilbake til den opprinnelige overflaten: 1 bevarer detaljer gjennom full projeksjon, mens 0 deaktiverer projeksjon for et jevnere resultat.

standard 90

Vinkelgrense for UV-chart i grader, som begrenser hvor mye normalene til naboflater kan avvike innenfor ett chart. En høyere grense favoriserer færre og større charts, med risiko for strekking; en lavere grense favoriserer flere charts og mindre forvrengning.

standard 0

Antall lokale forbedringspasseringer som brukes til å beregne UV-charts.

standard 1

UV-chart-balansen kan forbedres ved å øke antallet globale klyngingspasseringer som brukes til å beregne chartene.

standard 1

Juster hvor sterkt kantene på UV-chartene glattes; mindre synlige sømmer ved høyere innstillinger medfører risiko for UV-forvrengning.

Seed brukt for reproduserbar tilfeldig generering.

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

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om Trellis 2

Bygger en 3D-ressurs fra ett bilde (`image_url`) og returnerer en GLB-fil. `resolution` er 512, 1024 eller 1536, og `texture_size` er 1024, 2048 eller 4096. Hvert av de tre stadiene (struktur, form, tekstur) har egne kontroller for veiledning og samplingstrinn. `decimation_target` angir antallet nettvertekser (5,000 til 2,000,000), og alternativer for remeshing og UV-utpakking er tilgjengelige.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
seedvalgfritt
Typeinteger | null
Seed brukt for reproduserbar tilfeldig generering.
resolutionvalgfritt
Typeenum
Standard1024
51210241536
Oppløsning for utdata; høyere oppløsning gir flere detaljer, men tar lengre tid.
ss_guidance_strengthvalgfritt
Typenumber
Standard7.5
0 – 10
Kontroll for troskap mot den innledende 3D-strukturen: høyere verdi favoriserer bedre samsvar med inndatabildet, med risiko for mer støy.
ss_guidance_rescalevalgfritt
Typenumber
Standard0.7
0 – 1
Kontroll for veiledningsartefakter i trinn 1, der lave innstillinger gir sterkere veiledningseffekter og høye innstillinger gir mer stabile utdata.
ss_guidance_interval_startvalgfritt
Typenumber
Standard0.6
0 – 1
Startgrense for classifier-free guidance-vinduet i trinn 1 (sparse structure), uttrykt som en denoising-brøk. Lavere innstillinger starter veiledningen tidligere; bare intervallet fra interval_start til interval_end bruker veiledning, mens behandlingen ellers skjer uten veiledning.
ss_guidance_interval_endvalgfritt
Typenumber
Standard1
0 – 1
Veiledningsgrense for trinn 1 (sparse structure): velg en verdi som er minst like stor som ss_guidance_interval_start. Verdien angir brøken av denoising-fremdriften der classifier-free guidance stopper.
ss_sampling_stepsvalgfritt
Typeinteger
Standard12
1 – 50
Antall støyfjerningssteg for den innledende strukturen: mulige kvalitetsforbedringer fra flere steg gir langsommere behandling.
ss_rescale_tvalgfritt
Typenumber
Standard5
1 – 6
Angi overgangsskarphet gjennom støyskjemaet for strukturgenerering: høyere verdi gjør overgangene skarpere.
shape_slat_guidance_strengthvalgfritt
Typenumber
Standard7.5
0 – 10
Kontroll for troskap mot detaljert geometri: høyere samsvar med inndatabildet gir flere detaljer, med risiko for mer støy.
shape_slat_guidance_rescalevalgfritt
Typenumber
Standard0.5
0 – 1
Øk denne innstillingen når geometrien ser støyete ut: den reduserer artefakter forårsaket av sterk veiledning under formtrinnet.
shape_slat_guidance_interval_startvalgfritt
Typenumber
Standard0.6
0 – 1
Aktiveringspunkt for classifier-free guidance ved formforbedring i trinn 2. Uttrykt som en brøk av denoising-fremdriften angir den interval_start; veiledningen brukes bare i vinduet avgrenset av interval_start og interval_end.
shape_slat_guidance_interval_endvalgfritt
Typenumber
Standard1
0 – 1
Veiledningsgrense for trinn 2 (shape refinement): velg en verdi som er minst like stor som shape_slat_guidance_interval_start. Verdien angir brøken av denoising-fremdriften der classifier-free guidance stopper.
shape_slat_sampling_stepsvalgfritt
Typeinteger
Standard12
1 – 50
Antall støyfjerningssteg for formforbedring: jevnere geometri kan oppnås på bekostning av hastighet når flere steg brukes.
shape_slat_rescale_tvalgfritt
Typenumber
Standard3
1 – 6
Angi skarpheten for geometriske detaljer gjennom støyskjemaet for formforbedring; høyere verdi gir skarpere detaljer.
tex_slat_guidance_strengthvalgfritt
Typenumber
Standard1
0 – 10
Kontroll for fargetroskap i teksturen: bedre samsvar med fargene i inndatabildet ved høyere innstillinger øker intensiteten, men kan gi overmetning.
tex_slat_guidance_rescalevalgfritt
Typenumber
Standard0
0 – 1
Øk denne innstillingen for å håndtere støyete teksturer eller fargebånd: den reduserer artefakter forårsaket av sterk veiledning under teksturtrinnet.
tex_slat_guidance_interval_startvalgfritt
Typenumber
Standard0.6
0 – 1
Aktiveringspunkt for classifier-free guidance ved teksturgenerering i trinn 3. Uttrykt som en brøk av denoising-fremdriften angir den interval_start; veiledningen brukes bare i vinduet avgrenset av interval_start og interval_end.
tex_slat_guidance_interval_endvalgfritt
Typenumber
Standard0.9
0 – 1
Veiledningsgrense for trinn 3 (texture): velg en verdi som er minst like stor som tex_slat_guidance_interval_start. Verdien angir brøken av denoising-fremdriften der classifier-free guidance stopper.
tex_slat_sampling_stepsvalgfritt
Typeinteger
Standard12
1 – 50
Antall støyfjerningssteg brukt til å generere teksturer. Flere steg tar lengre tid, men kan gi renere teksturer.
tex_slat_rescale_tvalgfritt
Typenumber
Standard3
1 – 6
Angi skarpheten for teksturdetaljer gjennom støyskjemaet for teksturgenerering; høyere verdi gir skarpere detaljer.
decimation_targetvalgfritt
Typeinteger
Standard500000
5 000 – 2 000 000
Mål for antall mesh-vertices, med 500k anbefalt til generell bruk og 20k–50k for web/mobil. En reduksjon av målet bytter meshdetaljer mot mindre filer.
texture_sizevalgfritt
Typeenum
Standard2048
102420484096
Teksturoppløsning for baking av mesh. Finere overflatedetaljer gir større filer når oppløsningen økes.
remeshvalgfritt
Typeboolean
Standardtrue
Gjenoppbygging av topologien som oppretter renere meshtriangler, og vanligvis gjør meshen bedre egnet til senere bruk som animasjon eller 3D-printing, på bekostning av langsommere behandling.
remesh_bandvalgfritt
Typenumber
Standard1
0 – 4
Bevegelsesmargin for remeshing: ekstra utjevning kan ofre fine detaljer når denne verdien økes. Innstillingen begrenser vertex-forskyvningen i forhold til den opprinnelige overflaten.
remesh_projectvalgfritt
Typenumber
Standard0
0 – 1
Projeksjonsstyrke for å føre remesh-vertices tilbake til den opprinnelige overflaten: 1 bevarer detaljer gjennom full projeksjon, mens 0 deaktiverer projeksjon for et jevnere resultat.
uv_unwrap_angle_threshold_degvalgfritt
Typenumber
Standard90
0 – 180
Vinkelgrense for UV-chart i grader, som begrenser hvor mye normalene til naboflater kan avvike innenfor ett chart. En høyere grense favoriserer færre og større charts, med risiko for strekking; en lavere grense favoriserer flere charts og mindre forvrengning.
uv_unwrap_refine_iterationsvalgfritt
Typeinteger
Standard0
0 – 10
Antall lokale forbedringspasseringer som brukes til å beregne UV-charts.
uv_unwrap_global_iterationsvalgfritt
Typeinteger
Standard1
1 – 10
UV-chart-balansen kan forbedres ved å øke antallet globale klyngingspasseringer som brukes til å beregne chartene.
uv_unwrap_smooth_strengthvalgfritt
Typenumber
Standard1
0 – 10
Juster hvor sterkt kantene på UV-chartene glattes; mindre synlige sømmer ved høyere innstillinger medfører risiko for UV-forvrengning.
image_urlobligatorisk image
Typeurl · image
URL som peker til kildebildet for 3D-konvertering.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
model_glb
object {url, content_type, file_name, file_size}3D-modell generert i GLB-format.

Flere modeller: Bilde til 3D

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/trellis-2.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt