Siirry sisältöön

Hi3D Image to 3D · v3.0

Integroi

Mallin tunniste hitem3d/hi3d/v3.0/image-to-3d
# 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/v3.0/image-to-3d?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"

Esimerkin kaltaiset tiedostot: 2,10 $ 2 100 API-krediittiä · ≈ 225,67 ₽ tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Hitem3D Kuvasta 3D:ksi #image-to-3d#3d#mesh

Hi3D v3.0 muuntaa yksittäisen kuvan 3D-malliksi 2048-laadulla tai master-tarkkuudella ja tarjoaa varjostuksenpoiston säädön

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 syötekuva URL-osoitteena PNG-, JPEG- tai WebP-tiedostona, jonka koko on enintään 20 MB.

resolution oletus 2048quality

Generoinnin resoluution valitsin, joka tasapainottaa laatua ja nopeutta: valitse 2048master korkeimpaan laatuun tai oletusarvo 2048quality nopeampaan generointiin.

Lisäasetukset export_format · model · face_count · shading · enable_safety_checker
export_format oletus glb

Generoidun mallin tallennusmuoto.

oletus hi3dv3.0

Tämän päätepisteen Hi3D v3.0 -mallin versio.

Haluttu tahkomäärä; palveluntarjoajan suositukset ovat 2,000,000 arvolle 2048quality ja 5,000,000 arvolle 2048master.

oletus 0.5

Varjostuksen poiston voimakkuus.

POST /run/hitem3d/hi3d/v3.0/image-to-3d?wait=20 hinta → 2,10 $
# 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/v3.0/image-to-3d?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"

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 Image to 3D · v3.0

Luo 3D-mallin yhdestä enintään 20MB:n kuvasta. `resolution` on 2048quality tai 2048master, joista jälkimmäinen tarjoaa parhaan laadun. `face_count` voi olla enintään 5,000,000, ja `shading` (0–1) määrittää varjostuksenpoiston voimakkuuden. Tekstuuri- ja PBR-valitsimet ovat käytettävissä, ja vientimuotoina ovat glb, obj, stl, fbx tai usdz.

Parametrit

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

NimiTyyppi OletusSallitut Kuvaus
modelvalinnainen
Tyyppistring
Oletushi3dv3.0
Tämän päätepisteen Hi3D v3.0 -mallin versio.
resolutionvalinnainen
Tyyppienum
Oletus2048quality
2048quality2048master
Generoinnin resoluution valitsin, joka tasapainottaa laatua ja nopeutta: valitse 2048master korkeimpaan laatuun tai oletusarvo 2048quality nopeampaan generointiin.
enable_texturevalinnainen
Tyyppiboolean
Oletustrue
Määrittää, generoidaanko tekstuurit geometrian kanssa.
enable_pbrvalinnainen
Tyyppiboolean
Oletustrue
Määrittää, luodaanko PBR-materiaalikartat tekstuurin rinnalla.
face_countvalinnainen
Tyyppiinteger | null
100 000 – 5 000 000
Haluttu tahkomäärä; palveluntarjoajan suositukset ovat 2,000,000 arvolle 2048quality ja 5,000,000 arvolle 2048master.
export_formatvalinnainen
Tyyppienum
Oletusglb
glbobjstlfbxusdz
Generoidun mallin tallennusmuoto.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Syötekuvien turvallisuustarkistuksen valitsin: true edellyttää tarkistusta ennen kuvankäsittelyn aloittamista.
image_urlpakollinen image
Tyyppiurl · image
Toimita syötekuva URL-osoitteena PNG-, JPEG- tai WebP-tiedostona, jonka koko on enintään 20 MB.
shadingvalinnainen
Tyyppinumber
Oletus0.5
0 – 1
Varjostuksen poiston voimakkuus.
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/v3.0/image-to-3d",
  "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": 2100,
    "usd": "2.10",
    "charged": 2100,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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: Kuvasta 3D:ksi

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