Pereiti prie turinio

Trellis 2 · Retexture

Integruoti

Modelio id 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"

Ši užklausa: 0,24 $ 240 API kreditų · ≈ 25,31 ₽ Paleisti šiame puslapyje

Gauti API raktą
Microsoft Vaizdas į 3D #image-to-3d

Iš naujo tekstūruoja esamą netekstūruotą 3D tinklelį pagal atskaitos vaizdą ir pateikia GLB

Microsoft · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_url
Įmeskite failą arba

Etaloninio vaizdo URL, naudojamas tekstūravimui.

resolution numatytoji 1024

Tekstūros detalumas ir apdorojimo sparta priklauso nuo šios vidinės generavimo raiškos: ją padidinus gaunamos smulkesnės detalės, tačiau apdorojimas trunka ilgiau.

•privaloma

Neūtekstūruoto 3D tinklelio GLB, OBJ, PLY arba STL formatu tekstūravimo iš naujo šaltinio URL.

Išplėstiniai 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 numatytoji 2048

Tinklo tekstūros kepimo raiška. Didinant raišką gaunama daugiau paviršiaus detalių, bet failai tampa didesni.

numatytoji 1

Tekstūros spalvų tikslumo valdymas: didesnė reikšmė geriau išlaiko įvesties vaizdo spalvas ir didina sodrumą, tačiau gali sukelti persotinimą.

numatytoji 0

Padidinkite šią reikšmę, jei tekstūros triukšmingos arba matomos spalvų juostos: tai sumažina stipraus valdymo tekstūros etape sukeltus artefaktus.

numatytoji 0.6

Klasifikatoriaus nenaudojančio valdymo aktyvavimo taškas generuojant tekstūrą. Išreikštas triukšmo šalinimo progreso dalimi, jis nustato interval_start; valdymas veikia tik lange tarp interval_start ir interval_end.

numatytoji 0.9

Tekstūros etapo klasifikatoriaus nenaudojančio valdymo sustabdymo riba, nurodyta kaip triukšmo šalinimo dalis, ne mažesnė už tex_slat_guidance_interval_start.

numatytoji 12

Tekstūroms generuoti naudojamų triukšmo šalinimo žingsnių skaičius. Didesnis skaičius užtrunka ilgiau, bet gali suteikti švaresnes tekstūras.

numatytoji 3

Nustatykite tekstūros detalių ryškumą pagal tekstūros generavimo triukšmo tvarkaraštį; didesnė reikšmė suteikia ryškesnių detalių.

Atkuriamam atsitiktiniam generavimui naudojama pradžia.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Trellis 2 · Retexture

Pritaiko naują tekstūrą tinkleliui iš `mesh_url` (GLB, OBJ, PLY arba STL) pagal atskaitos `image_url`. `resolution` yra 512 arba 1024, o `texture_size` – 1024, 2048 arba 4096. Galimi tekstūros etapo valdymo ir mėginių ėmimo parametrai. Geometrija nesugeneruojama iš naujo.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Etaloninio vaizdo URL, naudojamas tekstūravimui.
mesh_urlprivaloma
Tipasstring
Neūtekstūruoto 3D tinklelio GLB, OBJ, PLY arba STL formatu tekstūravimo iš naujo šaltinio URL.
seedneprivalomas
Tipasinteger | null
Atkuriamam atsitiktiniam generavimui naudojama pradžia.
resolutionneprivalomas
Tipasenum
Numatytoji reikšmė1024
5121024
Tekstūros detalumas ir apdorojimo sparta priklauso nuo šios vidinės generavimo raiškos: ją padidinus gaunamos smulkesnės detalės, tačiau apdorojimas trunka ilgiau.
tex_slat_guidance_strengthneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 10
Tekstūros spalvų tikslumo valdymas: didesnė reikšmė geriau išlaiko įvesties vaizdo spalvas ir didina sodrumą, tačiau gali sukelti persotinimą.
tex_slat_guidance_rescaleneprivalomas
Tipasnumber
Numatytoji reikšmė0
0 – 1
Padidinkite šią reikšmę, jei tekstūros triukšmingos arba matomos spalvų juostos: tai sumažina stipraus valdymo tekstūros etape sukeltus artefaktus.
tex_slat_guidance_interval_startneprivalomas
Tipasnumber
Numatytoji reikšmė0.6
0 – 1
Klasifikatoriaus nenaudojančio valdymo aktyvavimo taškas generuojant tekstūrą. Išreikštas triukšmo šalinimo progreso dalimi, jis nustato interval_start; valdymas veikia tik lange tarp interval_start ir interval_end.
tex_slat_guidance_interval_endneprivalomas
Tipasnumber
Numatytoji reikšmė0.9
0 – 1
Tekstūros etapo klasifikatoriaus nenaudojančio valdymo sustabdymo riba, nurodyta kaip triukšmo šalinimo dalis, ne mažesnė už tex_slat_guidance_interval_start.
tex_slat_sampling_stepsneprivalomas
Tipasinteger
Numatytoji reikšmė12
1 – 50
Tekstūroms generuoti naudojamų triukšmo šalinimo žingsnių skaičius. Didesnis skaičius užtrunka ilgiau, bet gali suteikti švaresnes tekstūras.
tex_slat_rescale_tneprivalomas
Tipasnumber
Numatytoji reikšmė3
1 – 6
Nustatykite tekstūros detalių ryškumą pagal tekstūros generavimo triukšmo tvarkaraštį; didesnė reikšmė suteikia ryškesnių detalių.
texture_sizeneprivalomas
Tipasenum
Numatytoji reikšmė2048
102420484096
Tinklo tekstūros kepimo raiška. Didinant raišką gaunama daugiau paviršiaus detalių, bet failai tampa didesni.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
model_glb
object {url, content_type, file_name, file_size}GLB formatu sugeneruotas 3D modelis.

Daugiau modelių: Vaizdas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/trellis-2/retexture.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt