Siirry sisältöön

Hi3D Image to 3D

Integroi

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

Tämä pyyntö: ≈0,50 $ 500 API-krediittiä · ≈ 53,79 ₽ Suorita tällä sivulla

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

Yhden kuvan muunnos 3D-verkoksi, valittavat Hitem3D-versiot, pystykuvamuunnokset ja useat vientimuodot

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

Generoinnin resoluutio, oletuksena mallin suositus: v1.5/v2.0-malleille 1024 ja muuten fast-taso. Saatavilla ovat 512, 1024, 1536 ja 1536pro v1.5/v2.0-malleille; 1536fast ja 1536pro v2.1:lle; 1536 scene-portraitv1.5:lle; 1536pro scene-portraitv2.0:lle; sekä 1536profast ja 1536pro scene-portraitv2.1:lle.

Lisäasetukset model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model oletus hitem3dv2.1

Generointimallin valitsin: valitse muotokuva- ja hahmoihin viritetystä 'scene-portrait*'-malliperheestä tai yleiskäyttöisestä 'hitem3d*'-malliperheestä.

export_format oletus glb

Generoidun mallin tallennusmuoto.

Generoidun mallin haluttu tahkomäärä, joka ohittaa kumppanin resoluutioon perustuvan suosituksen. Jos arvo puuttuu, kumppani valitsee suosituksen, esimerkiksi 500k koolla 512, 1M koolla 1024 tai 2M koolla 1536.

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

Rakentaa 3D-mallin yhdestä kuvasta (PNG, JPEG tai WebP, enintään 20MB). `model`-asetus sisältää yleiset ja muotokuviin optimoidut versiot, ja sallitut `resolution`-arvot riippuvat siitä. Tekstuuri- ja PBR-kartat voidaan ottaa käyttöön, `face_count` on välillä 100,000–2,000,000, ja vientimuoto voi olla glb, obj, stl, fbx tai usdz.

Parametrit

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

NimiTyyppi OletusSallitut Kuvaus
modelvalinnainen
Tyyppienum
Oletushitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
Generointimallin valitsin: valitse muotokuva- ja hahmoihin viritetystä 'scene-portrait*'-malliperheestä tai yleiskäyttöisestä 'hitem3d*'-malliperheestä.
resolutionvalinnainen
Tyyppienum
512102415361536pro1536fast1536profast
Generoinnin resoluutio, oletuksena mallin suositus: v1.5/v2.0-malleille 1024 ja muuten fast-taso. Saatavilla ovat 512, 1024, 1536 ja 1536pro v1.5/v2.0-malleille; 1536fast ja 1536pro v2.1:lle; 1536 scene-portraitv1.5:lle; 1536pro scene-portraitv2.0:lle; sekä 1536profast ja 1536pro scene-portraitv2.1:lle.
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 – 2 000 000
Generoidun mallin haluttu tahkomäärä, joka ohittaa kumppanin resoluutioon perustuvan suosituksen. Jos arvo puuttuu, kumppani valitsee suosituksen, esimerkiksi 500k koolla 512, 1M koolla 1024 tai 2M koolla 1536.
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.
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/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": 500,
    "usd": "0.50",
    "charged": 500,
    "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/image-to-3d.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt