Preskoči na vsebino

Trellis 2 · Retexture

Integracija

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

Ta zahteva: 0,24 $ 240 API kreditov Zaženi na tej strani

Pridobi ključ API
Microsoft Slika v 3D #image-to-3d

Ponovno teksturira obstoječo neteksturirano 3D-mrežo glede na referenčno sliko in vrne GLB

Microsoft · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno image_url
Spustite datoteko ali

URL referenčne slike za teksturiranje.

resolution privzeto 1024

Podrobnosti teksture in hitrost obdelave sta odvisni od te notranje ločljivosti generiranja: povečanje ustvari bolj drobne podrobnosti, vendar traja dlje.

•obvezno

URL vira za ponovno teksturiranje neimeturirane 3D-mreže v obliki GLB, OBJ, PLY ali STL.

Napredno 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 privzeto 2048

Ločljivost teksture mreže za pečenje. Pri višji ločljivosti so površinske podrobnosti natančnejše, datoteke pa večje.

privzeto 1

Nadzor zvestobe barv teksture: večje ujemanje z barvami vhodne slike pri višjih nastavitvah poveča živahnost, vendar lahko povzroči prenasičenost.

privzeto 0

To nastavitev povečajte za odpravljanje šumnih tekstur ali barvnih pasov: zmanjša artefakte, ki jih povzroči močno vodenje med fazo teksture.

privzeto 0.6

Točka aktiviranja classifier-free guidance za generiranje teksture. Izražena kot delež napredka odstranjevanja šuma nastavi interval_start; usmerjanje deluje samo znotraj okna med interval_start in interval_end.

privzeto 0.9

Končna meja classifier-free guidance stopnje teksture, določena kot delež odstranjevanja šuma, ki ni manjši od tex_slat_guidance_interval_start.

privzeto 12

Število korakov odstranjevanja šuma za ustvarjanje tekstur. Večje število traja dlje, vendar lahko ustvari čistejše teksture.

privzeto 3

Nastavite ostrino podrobnosti teksture z razporedom šuma pri ustvarjanju teksture; višja vrednost ustvari ostrejše podrobnosti.

Seme za ponovljivo naključno ustvarjanje.

POST /run/trellis-2/retexture?wait=20 cena → 0,24 $
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Trellis 2 · Retexture

Uporabi novo teksturo na mreži na `mesh_url` (GLB, OBJ, PLY ali STL) na podlagi referenčne `image_url`. `resolution` je 512 ali 1024, `texture_size` pa 1024, 2048 ali 4096. Na voljo so nastavitve vodenja in vzorčenja za stopnjo teksture. Geometrija se ne ustvari znova.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlobvezno image
Vrstaurl · image
URL referenčne slike za teksturiranje.
mesh_urlobvezno
Vrstastring
URL vira za ponovno teksturiranje neimeturirane 3D-mreže v obliki GLB, OBJ, PLY ali STL.
seedneobvezno
Vrstainteger | null
Seme za ponovljivo naključno ustvarjanje.
resolutionneobvezno
Vrstaenum
Privzeto1024
5121024
Podrobnosti teksture in hitrost obdelave sta odvisni od te notranje ločljivosti generiranja: povečanje ustvari bolj drobne podrobnosti, vendar traja dlje.
tex_slat_guidance_strengthneobvezno
Vrstanumber
Privzeto1
0 – 10
Nadzor zvestobe barv teksture: večje ujemanje z barvami vhodne slike pri višjih nastavitvah poveča živahnost, vendar lahko povzroči prenasičenost.
tex_slat_guidance_rescaleneobvezno
Vrstanumber
Privzeto0
0 – 1
To nastavitev povečajte za odpravljanje šumnih tekstur ali barvnih pasov: zmanjša artefakte, ki jih povzroči močno vodenje med fazo teksture.
tex_slat_guidance_interval_startneobvezno
Vrstanumber
Privzeto0.6
0 – 1
Točka aktiviranja classifier-free guidance za generiranje teksture. Izražena kot delež napredka odstranjevanja šuma nastavi interval_start; usmerjanje deluje samo znotraj okna med interval_start in interval_end.
tex_slat_guidance_interval_endneobvezno
Vrstanumber
Privzeto0.9
0 – 1
Končna meja classifier-free guidance stopnje teksture, določena kot delež odstranjevanja šuma, ki ni manjši od tex_slat_guidance_interval_start.
tex_slat_sampling_stepsneobvezno
Vrstainteger
Privzeto12
1 – 50
Število korakov odstranjevanja šuma za ustvarjanje tekstur. Večje število traja dlje, vendar lahko ustvari čistejše teksture.
tex_slat_rescale_tneobvezno
Vrstanumber
Privzeto3
1 – 6
Nastavite ostrino podrobnosti teksture z razporedom šuma pri ustvarjanju teksture; višja vrednost ustvari ostrejše podrobnosti.
texture_sizeneobvezno
Vrstaenum
Privzeto2048
102420484096
Ločljivost teksture mreže za pečenje. Pri višji ločljivosti so površinske podrobnosti natančnejše, datoteke pa večje.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
model_glb
object {url, content_type, file_name, file_size}3D-model, ustvarjen v obliki GLB.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/trellis-2/retexture.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt