Trellis 2

Integrer

Model-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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/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.ru/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/da/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/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"
  }
}

Kald Trellis 2-modellen (trellis-2) via Doitong API. Dokumentation til agenter: https://doitong.com/da/developers/models/trellis-2.md

POST https://api.doitong.ru/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"
}

Hvis svarstatus er "queued" eller "running", skal du forespørge GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 igen, indtil den er "succeeded"; filerne findes i outputs[].url. POST https://api.doitong.ru/v1/quote/trellis-2 med samme body returnerer den nøjagtige pris før kørslen.

Denne anmodning: 0,30 $ 300 API-kreditter · ≈ 31,64 ₽ Kør den på denne side

Hent API-nøgle

Microsoft Billede til 3D #image-to-3d

Omdanner ét billede til et tekstureret GLB 3D-mesh med justerbare indstillinger for struktur, form, tekstur og UV

OpenAPI Markdown

Microsoft · 3D

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

image •påkrævet image_url

Slip en fil, eller

URL, der peger på kildebilledet til 3D-konvertering.

resolution standard 1024

Outputtets opløsning; en højere opløsning tilføjer detaljer, men tager længere tid.

Avanceret 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

Mesh-teksturopløsning til baking. Finere overfladedetaljer medfører større filer, når denne opløsning øges.

ss_guidance_strength standard 7.5

Kontrol af den indledende 3D-strukturs nøjagtighed: en højere værdi prioriterer større overensstemmelse med inputbilledet med risiko for mere støj.

ss_guidance_rescale standard 0.7

Kontrol af vejledningsartefakter i trin 1, hvor lave indstillinger giver stærkere vejledningseffekter, mens høje indstillinger giver et mere stabilt output.

ss_guidance_interval_start standard 0.6

Startgrænse for classifier-free guidance-vinduet i trin 1 (sparsom struktur), angivet som en denoising-brøk. Lavere indstillinger starter vejledningen tidligere; kun intervallet fra interval_start til interval_end bruger vejledning, mens behandlingen ellers foregår uden vejledning.

ss_guidance_interval_end standard 1

Vejledningsgrænse for trin 1 (sparsom struktur): vælg en værdi, der er mindst lige så stor som ss_guidance_interval_start. Værdien angiver den brøkdel af denoising, der er nået, når classifier-free guidance stopper.

ss_sampling_steps standard 12

Antal denoising-trin for den indledende struktur: mulige kvalitetsforbedringer fra ekstra trin medfører langsommere behandling.

ss_rescale_t standard 5

Angiv overgangsskarphed via støjplanen for strukturgenerering: en højere værdi gør overgange skarpere.

shape_slat_guidance_strength standard 7.5

Kontrol af nøjagtigheden for detaljeret geometri: større overensstemmelse med inputbilledet giver flere detaljer med risiko for mere støj.

shape_slat_guidance_rescale standard 0.5

Øg denne indstilling, når geometrien ser støjfyldt ud: den reducerer artefakter forårsaget af stærk vejledning under formtrinnet.

shape_slat_guidance_interval_start standard 0.6

Aktiveringspunkt for classifier-free guidance til formforfinelse i trin 2. Angivet som en brøkdel af denoising-fremskridtet sætter den interval_start; vejledningen fungerer kun i vinduet mellem interval_start og interval_end.

shape_slat_guidance_interval_end standard 1

Vejledningsgrænse for trin 2 (formforfinelse): vælg en værdi, der er mindst lige så stor som shape_slat_guidance_interval_start. Værdien angiver den brøkdel af denoising, der er nået, når classifier-free guidance stopper.

shape_slat_sampling_steps standard 12

Antal denoising-trin til formforfining: potentielt glattere geometri sker på bekostning af hastigheden, når der bruges ekstra trin.

shape_slat_rescale_t standard 3

Angiv skarpheden af geometriske detaljer via støjplanen for formforfining; en højere værdi giver skarpere detaljer.

tex_slat_guidance_strength standard 1

Kontrol af teksturfarvers nøjagtighed: større overensstemmelse med farverne i inputbilledet ved højere indstillinger øger intensiteten, men kan medføre overmætning.

tex_slat_guidance_rescale standard 0

Øg denne indstilling for at afhjælpe støjfyldte teksturer eller farvebånding: den reducerer artefakter forårsaget af stærk vejledning under teksturtrinnet.

tex_slat_guidance_interval_start standard 0.6

Aktiveringspunkt for classifier-free guidance til teksturgenerering i trin 3. Angivet som en brøkdel af denoising-fremskridtet sætter den interval_start; vejledningen fungerer kun i vinduet mellem interval_start og interval_end.

tex_slat_guidance_interval_end standard 0.9

Vejledningsgrænse for trin 3 (tekstur): vælg en værdi, der er mindst lige så stor som tex_slat_guidance_interval_start. Værdien angiver den brøkdel af denoising, der er nået, når classifier-free guidance stopper.

tex_slat_sampling_steps standard 12

Antal denoising-trin, der bruges til at generere teksturer. Et højere antal trin tager længere tid, men kan give renere teksturer.

tex_slat_rescale_t standard 3

Angiv skarpheden af teksturdetaljer via støjplanen for teksturgenerering; en højere værdi giver skarpere detaljer.

decimation_target standard 500000

Mål for mesh-vertexantal, hvor 500k anbefales til generel brug og 20k–50k til web/mobil. En reduktion af målet bytter meshdetaljer for mindre filer.

remesh_band standard 1

Bevægelsesfrihed ved remeshing: ekstra udglatning kan ofre fine detaljer, når denne værdi øges. Indstillingen begrænser vertex-forskydningen i forhold til den oprindelige overflade.

remesh_project standard 0

Projektionsstyrke for at føre remesh-vertices tilbage til den oprindelige overflade: 1 bevarer detaljer gennem fuld projektion, mens 0 deaktiverer projektion for et glattere resultat.

uv_unwrap_angle_threshold_deg standard 90

Vinkelgrænse for UV-charts i grader, som begrænser, hvor meget tilstødende normalenheder må afvige inden for ét chart. En højere grænse favoriserer færre, større charts med risiko for strækning; en lavere grænse favoriserer flere charts og mindre forvrængning.

uv_unwrap_refine_iterations standard 0

Antal lokale forfiningspassager brugt til at beregne UV-charts.

uv_unwrap_global_iterations standard 1

UV-chart-balancen kan forbedres ved at øge antallet af globale klyngepassager, der bruges til at beregne charts.

uv_unwrap_smooth_strength standard 1

Juster, hvor kraftigt UV-chart-kanter udglattes; mindre synlige sømme ved højere indstillinger indebærer risiko for UV-forvrængning.

seed

Seed til reproducerbar tilfældig 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/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.ru/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
    }
  }
}

Kør denne anmodning

API-nøgle

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Husk i denne browser Hent en API-nøgle

Om Trellis 2

Bygger et 3D-asset fra ét billede (`image_url`) og returnerer en GLB-fil. `resolution` er 512, 1024 eller 1536, og `texture_size` er 1024, 2048 eller 4096. Hver af tre faser (struktur, form, tekstur) har egne kontroller til guidance og samplingtrin. `decimation_target` angiver antallet af mesh-vertices (5,000 til 2,000,000), og indstillinger til remeshing og UV-udfoldning er tilgængelige.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse

seedvalgfri

Typeinteger | null

Seed til reproducerbar tilfældig generering.

resolutionvalgfri

Typeenum

Standard1024

51210241536

Outputtets opløsning; en højere opløsning tilføjer detaljer, men tager længere tid.

ss_guidance_strengthvalgfri

Typenumber

Standard7.5

0 – 10

Kontrol af den indledende 3D-strukturs nøjagtighed: en højere værdi prioriterer større overensstemmelse med inputbilledet med risiko for mere støj.

ss_guidance_rescalevalgfri

Typenumber

Standard0.7

0 – 1

Kontrol af vejledningsartefakter i trin 1, hvor lave indstillinger giver stærkere vejledningseffekter, mens høje indstillinger giver et mere stabilt output.

ss_guidance_interval_startvalgfri

Typenumber

Standard0.6

0 – 1

ss_guidance_interval_endvalgfri

Typenumber

Standard1

0 – 1

ss_sampling_stepsvalgfri

Typeinteger

Standard12

1 – 50

Antal denoising-trin for den indledende struktur: mulige kvalitetsforbedringer fra ekstra trin medfører langsommere behandling.

ss_rescale_tvalgfri

Typenumber

Standard5

1 – 6

Angiv overgangsskarphed via støjplanen for strukturgenerering: en højere værdi gør overgange skarpere.

shape_slat_guidance_strengthvalgfri

Typenumber

Standard7.5

0 – 10

Kontrol af nøjagtigheden for detaljeret geometri: større overensstemmelse med inputbilledet giver flere detaljer med risiko for mere støj.

shape_slat_guidance_rescalevalgfri

Typenumber

Standard0.5

0 – 1

Øg denne indstilling, når geometrien ser støjfyldt ud: den reducerer artefakter forårsaget af stærk vejledning under formtrinnet.

shape_slat_guidance_interval_startvalgfri

Typenumber

Standard0.6

0 – 1

shape_slat_guidance_interval_endvalgfri

Typenumber

Standard1

0 – 1

shape_slat_sampling_stepsvalgfri

Typeinteger

Standard12

1 – 50

Antal denoising-trin til formforfining: potentielt glattere geometri sker på bekostning af hastigheden, når der bruges ekstra trin.

shape_slat_rescale_tvalgfri

Typenumber

Standard3

1 – 6

Angiv skarpheden af geometriske detaljer via støjplanen for formforfining; en højere værdi giver skarpere detaljer.

tex_slat_guidance_strengthvalgfri

Typenumber

Standard1

0 – 10

Kontrol af teksturfarvers nøjagtighed: større overensstemmelse med farverne i inputbilledet ved højere indstillinger øger intensiteten, men kan medføre overmætning.

tex_slat_guidance_rescalevalgfri

Typenumber

Standard0

0 – 1

Øg denne indstilling for at afhjælpe støjfyldte teksturer eller farvebånding: den reducerer artefakter forårsaget af stærk vejledning under teksturtrinnet.

tex_slat_guidance_interval_startvalgfri

Typenumber

Standard0.6

0 – 1

tex_slat_guidance_interval_endvalgfri

Typenumber

Standard0.9

0 – 1

tex_slat_sampling_stepsvalgfri

Typeinteger

Standard12

1 – 50

Antal denoising-trin, der bruges til at generere teksturer. Et højere antal trin tager længere tid, men kan give renere teksturer.

tex_slat_rescale_tvalgfri

Typenumber

Standard3

1 – 6

Angiv skarpheden af teksturdetaljer via støjplanen for teksturgenerering; en højere værdi giver skarpere detaljer.

decimation_targetvalgfri

Typeinteger

Standard500000

5.000 – 2.000.000

Mål for mesh-vertexantal, hvor 500k anbefales til generel brug og 20k–50k til web/mobil. En reduktion af målet bytter meshdetaljer for mindre filer.

texture_sizevalgfri

Typeenum

Standard2048

102420484096

Mesh-teksturopløsning til baking. Finere overfladedetaljer medfører større filer, når denne opløsning øges.

remeshvalgfri

Typeboolean

Standardtrue

Genopbygning af topologien, som skaber renere meshtriangler og normalt forbedrer egnetheden til senere anvendelser som animation eller 3D-print på bekostning af langsommere behandling.

remesh_bandvalgfri

Typenumber

Standard1

0 – 4

Bevægelsesfrihed ved remeshing: ekstra udglatning kan ofre fine detaljer, når denne værdi øges. Indstillingen begrænser vertex-forskydningen i forhold til den oprindelige overflade.

remesh_projectvalgfri

Typenumber

Standard0

0 – 1

Projektionsstyrke for at føre remesh-vertices tilbage til den oprindelige overflade: 1 bevarer detaljer gennem fuld projektion, mens 0 deaktiverer projektion for et glattere resultat.

uv_unwrap_angle_threshold_degvalgfri

Typenumber

Standard90

0 – 180

uv_unwrap_refine_iterationsvalgfri

Typeinteger

Standard0

0 – 10

Antal lokale forfiningspassager brugt til at beregne UV-charts.

uv_unwrap_global_iterationsvalgfri

Typeinteger

Standard1

1 – 10

UV-chart-balancen kan forbedres ved at øge antallet af globale klyngepassager, der bruges til at beregne charts.

uv_unwrap_smooth_strengthvalgfri

Typenumber

Standard1

0 – 10

Juster, hvor kraftigt UV-chart-kanter udglattes; mindre synlige sømme ved højere indstillinger indebærer risiko for UV-forvrængning.

image_urlpåkrævet image

Typeurl · image

URL, der peger på kildebilledet til 3D-konvertering.

påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.

Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.

Outputfelter

model_glb: object {url, content_type, file_name, file_size}3D-model genereret i GLB-format.

Flere modeller: Billede til 3D

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/trellis-2.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt

Dit første resultat kommer her

Opret en anmodning

Kør denne anmodning

Om Trellis 2

Parametre

Output

Andre Trellis 2-varianter

Trellis 2 · Retexture Varianter: 2

Flere modeller: Billede til 3D

Trellis Varianter: 2

Trellis · Multi Varianter: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Varianter: 6