Saltar al cuntegna

Trellis 2 · Retexture

Integrar

ID dal model trellis-2/retexture
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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"

Questa dumonda: $0,24 240 credits API · ≈ ₽25,31 Lantschar sin questa pagina

Obtegna ina clav API
Microsoft Maletg a 3D #image-to-3d

Dat ina nova textur ad ina mesh 3D existenta senza textur per la far correspunder ad ina imagina da referenza, cun output GLB

Microsoft · 3D

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori image_url
Trametta in datoteca u

URL dal maletg da referenza utilisà per la texturaziun.

resolution standard 1024

Ils detagls da la textura e la spertadad da l'elavuraziun dependan da questa resoluziun interna da generaziun: in augment producescha detagls pli fins, ma dovra dapli temp.

•obligatori

URL da funtauna per la retexturaziun d'ina rait 3D senza textura en format GLB, OBJ, PLY u STL.

Avanzà texture_size · 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 · seed
texture_size standard 2048

Resoluziun da la textura dal mesh per il baking. Detagl da surfatscha pli fin dat datotecas pli grondas sch'igl vegn augmentada questa resoluziun.

standard 1

Controlla la fidelitad da la colur da la textura: ina aderenza pli gronda a las colurs dal maletg input tar configuraziuns autas augmenta la vivacitad, ma po chaschunar sursaturaziun.

standard 0

Augmenta questa configuraziun per tractar texturas ramurusas u bandas da colur: ella reducescha ils artifacts chaschunads da la guida ferma durant il stadi da la textura.

standard 0.6

Punct d'activaziun da la guidance senza classificader per la generaziun da la textura. Exprimì sco fracziun dal progress da reducziun dal ramur, fixescha el interval_start; la guidance funcziuna mo en la fanestra limitada da interval_start e interval_end.

standard 0.9

Limita da fermada per la guidance senza classificader da la fasa da la textura, inditgada sco fracziun da reducziun dal ramur betg pli pitschna che tex_slat_guidance_interval_start.

standard 12

Dumber da pass da denoising utilisads per generar texturas. Augmentar il dumber da pass dovra dapli temp, ma po producir texturas pli nettas.

standard 3

Definescha la nettezza dal detagl da la textura tras il noise schedule da la generaziun da texturas; augmentar questa valur dat detagls pli nets.

Seed utilisà per ina generaziun casuala reproducibla.

POST /run/trellis-2/retexture?wait=20 calculaziun → $0,24
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Trellis 2 · Retexture

Applitgescha ina nova textur a la mesh da `mesh_url` (GLB, OBJ, PLY u STL) a basa d'ina `image_url` da referenza. `resolution` è 512 u 1024; `texture_size` è 1024, 2048 u 4096. Controlls da guidance e sampling per la staziun da textur èn disponibels. La geometria na vegn betg regenerada.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL dal maletg da referenza utilisà per la texturaziun.
mesh_urlobligatori
Tipstring
URL da funtauna per la retexturaziun d'ina rait 3D senza textura en format GLB, OBJ, PLY u STL.
seedopziunal
Tipinteger | null
Seed utilisà per ina generaziun casuala reproducibla.
resolutionopziunal
Tipenum
Standard1024
5121024
Ils detagls da la textura e la spertadad da l'elavuraziun dependan da questa resoluziun interna da generaziun: in augment producescha detagls pli fins, ma dovra dapli temp.
tex_slat_guidance_strengthopziunal
Tipnumber
Standard1
0 – 10
Controlla la fidelitad da la colur da la textura: ina aderenza pli gronda a las colurs dal maletg input tar configuraziuns autas augmenta la vivacitad, ma po chaschunar sursaturaziun.
tex_slat_guidance_rescaleopziunal
Tipnumber
Standard0
0 – 1
Augmenta questa configuraziun per tractar texturas ramurusas u bandas da colur: ella reducescha ils artifacts chaschunads da la guida ferma durant il stadi da la textura.
tex_slat_guidance_interval_startopziunal
Tipnumber
Standard0.6
0 – 1
Punct d'activaziun da la guidance senza classificader per la generaziun da la textura. Exprimì sco fracziun dal progress da reducziun dal ramur, fixescha el interval_start; la guidance funcziuna mo en la fanestra limitada da interval_start e interval_end.
tex_slat_guidance_interval_endopziunal
Tipnumber
Standard0.9
0 – 1
Limita da fermada per la guidance senza classificader da la fasa da la textura, inditgada sco fracziun da reducziun dal ramur betg pli pitschna che tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopziunal
Tipinteger
Standard12
1 – 50
Dumber da pass da denoising utilisads per generar texturas. Augmentar il dumber da pass dovra dapli temp, ma po producir texturas pli nettas.
tex_slat_rescale_topziunal
Tipnumber
Standard3
1 – 6
Definescha la nettezza dal detagl da la textura tras il noise schedule da la generaziun da texturas; augmentar questa valur dat detagls pli nets.
texture_sizeopziunal
Tipenum
Standard2048
102420484096
Resoluziun da la textura dal mesh per il baking. Detagl da surfatscha pli fin dat datotecas pli grondas sch'igl vegn augmentada questa resoluziun.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
model_glb
object {url, content_type, file_name, file_size}Model 3D generà en format GLB.

Dapli models: Maletg a 3D

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/trellis-2/retexture.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt