Siirry sisältöön

Hi3D Texture

Integroi

Mallin tunniste hitem3d/hi3d/texture
# 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/hitem3d/hi3d/texture?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"

Tämä pyyntö: ≈0,30 $ 300 API-krediittiä · ≈ 31,64 ₽ Suorita tällä sivulla

Hanki API-avain
Hitem3D · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen image_url
Pudota tiedosto tai

Toimita teksturoinnin viite URL-osoitteena PNG-, JPEG- tai WebP-kuvana, jonka enimmäiskoko on 20 MB.

resolution

Valitse tekstuurin resoluutio tai jätä arvo määrittämättä mallin suosituksen käyttämiseksi. scene-portraitv1.5 tukee vain arvoa 1536, kun taas hitem3dv1.5 tukee arvoja 512, 1024, 1536 ja 1536pro.

•pakollinen

Toimita teksturoitava geometria URL-osoitteena GLB-muodossa; muita muotoja ei tueta. Sopiva lähde on esimerkiksi `enable_texture=false`-asetuksella generoitu kuva-3D-geometriatuloste.

Lisäasetukset model · export_format · enable_safety_checker
model oletus hitem3dv1.5

Teksturoinnissa käytettävän mallin versio. Vaiheistettu teksturointitehtävä edellyttää v1.5-mallia.

export_format oletus glb

Generoidun mallin tallennusmuoto.

POST /run/hitem3d/hi3d/texture?wait=20 hinta → 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/hitem3d/hi3d/texture?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"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Hi3D Texture

Lisää tekstuurin olemassa olevaan, vain geometrian sisältävään GLB-tiedostoon viitekuvan (PNG, JPEG tai WebP, enintään 20MB) ohjaamana. Vain v1.5-malleja tuetaan: hitem3dv1.5 tarjoaa tarkkuudet 512–1536pro, kun taas muotokuvaversio käyttää tarkkuutta 1536. Vientimuodot ovat glb, obj, stl, fbx ja usdz.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
Toimita teksturoinnin viite URL-osoitteena PNG-, JPEG- tai WebP-kuvana, jonka enimmäiskoko on 20 MB.
mesh_urlpakollinen
Tyyppistring
Toimita teksturoitava geometria URL-osoitteena GLB-muodossa; muita muotoja ei tueta. Sopiva lähde on esimerkiksi `enable_texture=false`-asetuksella generoitu kuva-3D-geometriatuloste.
modelvalinnainen
Tyyppienum
Oletushitem3dv1.5
hitem3dv1.5scene-portraitv1.5
Teksturoinnissa käytettävän mallin versio. Vaiheistettu teksturointitehtävä edellyttää v1.5-mallia.
resolutionvalinnainen
Tyyppienum
512102415361536pro
Valitse tekstuurin resoluutio tai jätä arvo määrittämättä mallin suosituksen käyttämiseksi. scene-portraitv1.5 tukee vain arvoa 1536, kun taas hitem3dv1.5 tukee arvoja 512, 1024, 1536 ja 1536pro.
export_formatvalinnainen
Tyyppienum
Oletusglb
glbobjstlfbxusdz
Generoidun mallin tallennusmuoto.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Syötekuvien turvallisuustarkistuksen valitsin: true edellyttää tarkistusta ennen kuvankäsittelyn aloittamista.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/texture",
  "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",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "model_mesh": {
      "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
    },
    "thumbnail": {
      "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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
model_mesh
object {url, content_type, file_name, file_size}Generoidun 3D-mallin sisältävä tiedosto.
thumbnail
object {url, content_type, file_name, file_size} | nullMallin esikatselukuva, jos saatavilla.

Lisää malleja: 3D

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/hitem3d/hi3d/texture.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt