Léim chuig an ábhar

Hi3D Image to 3D

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: ≈$0.50 500 gcreidmheas API · ≈ ₽53.79 Rith ar an leathanach seo

Faigh eochair API
Hitem3D Íomhá go 3D #image-to-3d#3d#mesh

Íomhá aonair go mogalra 3D le leaganacha roghnacha Hitem3D, malairtí portráide agus go leor formáidí easpórtála

Hitem3D · 3D

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach image_url
Scaoil comhad, nó

Soláthair an íomhá ionchuir trí URL mar chomhad PNG, JPEG nó WebP nach mó ná 20 MB.

resolution

Taifeach giniúna, réamhshocraithe de réir mholadh na samhla: 1024 do v1.5/v2.0 agus an tsraith thapa murach sin. Is iad na roghanna atá ar fáil 512, 1024, 1536 agus 1536pro do v1.5/v2.0; 1536fast agus 1536pro do v2.1; 1536 do scene-portraitv1.5; 1536pro do scene-portraitv2.0; agus 1536profast agus 1536pro do scene-portraitv2.1.

Ardleibhéal model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model réamhshocrú hitem3dv2.1

Roghnóir samhla giniúna: roghnaigh ón teaghlach 'scene-portrait*' atá tiúnáilte do phortráidí agus carachtair, nó ón teaghlach ilchuspóireach 'hitem3d*'.

export_format réamhshocrú glb

Formáid a úsáidtear chun an tsamhail ginte a shábháil.

Líon inmhianaithe aghaidheanna don tsamhail ginte, ag sárú mholadh an chomhpháirtí bunaithe ar thaifeach. Má fhágtar ar lár é, roghnaíonn an comhpháirtí an moladh sin, mar shampla 500k ag 512, 1M ag 1024, nó 2M ag 1536.

POST /run/hitem3d/hi3d/image-to-3d?wait=20 luachan → $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"

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Hi3D Image to 3D

Tógann sé samhail 3D ó íomhá amháin (PNG, JPEG nó WebP, suas le 20MB). Áiríonn an rogha `model` leaganacha ginearálta agus tiúnta do phortráidí, agus braitheann na luachanna ceadaithe `resolution` air. Is féidir léarscáileanna uigeachta agus PBR a chasadh air nó as, raontaíonn `face_count` ó 100,000 go 2,000,000, agus is iad glb, obj, stl, fbx nó usdz na formáidí easpórtála.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
modelroghnach
Cineálenum
Réamhshocrúhitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
Roghnóir samhla giniúna: roghnaigh ón teaghlach 'scene-portrait*' atá tiúnáilte do phortráidí agus carachtair, nó ón teaghlach ilchuspóireach 'hitem3d*'.
resolutionroghnach
Cineálenum
512102415361536pro1536fast1536profast
Taifeach giniúna, réamhshocraithe de réir mholadh na samhla: 1024 do v1.5/v2.0 agus an tsraith thapa murach sin. Is iad na roghanna atá ar fáil 512, 1024, 1536 agus 1536pro do v1.5/v2.0; 1536fast agus 1536pro do v2.1; 1536 do scene-portraitv1.5; 1536pro do scene-portraitv2.0; agus 1536profast agus 1536pro do scene-portraitv2.1.
enable_textureroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé an ngintear uigeachtaí in éineacht leis an gcéimseata.
enable_pbrroghnach
Cineálboolean
Réamhshocrútrue
Rialaíonn sé an gcruthaítear léarscáileanna ábhair PBR taobh leis an uigeacht.
face_countroghnach
Cineálinteger | null
100,000 – 2,000,000
Líon inmhianaithe aghaidheanna don tsamhail ginte, ag sárú mholadh an chomhpháirtí bunaithe ar thaifeach. Má fhágtar ar lár é, roghnaíonn an comhpháirtí an moladh sin, mar shampla 500k ag 512, 1M ag 1024, nó 2M ag 1536.
export_formatroghnach
Cineálenum
Réamhshocrúglb
glbobjstlfbxusdz
Formáid a úsáidtear chun an tsamhail ginte a shábháil.
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrútrue
Scorán seiceála sábháilteachta d’íomhánna ionchuir: éilíonn true seiceáil sábháilteachta sula dtosaíonn próiseáil na híomhá.
image_urlriachtanach image
Cineálurl · image
Soláthair an íomhá ionchuir trí URL mar chomhad PNG, JPEG nó WebP nach mó ná 20 MB.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
model_mesh
object {url, content_type, file_name, file_size}Comhad ina bhfuil an tsamhail 3D ginte.
thumbnail
object {url, content_type, file_name, file_size} | nullÍomhá réamhamhairc den tsamhail, curtha ar fáil nuair is féidir.

Tuilleadh samhlacha: Íomhá go 3D

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/hitem3d/hi3d/image-to-3d.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt