Ruka hadi kwenye maudhui

Hi3D Texture

Unganisha

Kitambulisho cha modeli 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"

Ombi hili: ≈$ 0.30 salio za API 300 · ≈ ₽ 31.41 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Hitem3D · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika image_url
Dondosha faili, au

Toa marejeo ya texture kwa URL, ukitumia picha ya PNG, JPEG au WebP yenye ukubwa wa juu wa 20 MB.

resolution

Chagua mwonekano wa texture au uache bila kuweka ili kutumia pendekezo la modeli. Kwa scene-portraitv1.5 chaguo pekee ni 1536, ilhali hitem3dv1.5 inatumia 512, 1024, 1536 na 1536pro.

•inahitajika

Toa jiometri ya kuweka texture kwa URL katika umbizo la GLB; hakuna umbizo jingine linaloungwa mkono. Chanzo kimoja kinachofaa ni tokeo la jiometri ya image-to-3d lililozalishwa kwa enable_texture=false.

Ya kina model · export_format · enable_safety_checker
model chaguomsingi hitem3dv1.5

Toleo la modeli la kutumia kwa kuweka texture. Kazi ya texture iliyopangwa inahitaji modeli ya v1.5.

export_format chaguomsingi glb

Umbizo linalotumika kuhifadhi modeli iliyozalishwa.

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

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Hi3D Texture

Huweka tekstura kwenye jiometri iliyopo ya GLB pekee, ikiongozwa na picha ya rejeleo (PNG, JPEG au WebP, hadi 20MB). Modeli za v1.5 pekee ndizo zinazotumika: hitem3dv1.5 inatoa mwonekano wa 512 hadi 1536pro, huku toleo la portrait likitumia 1536. Miundo ya uhamishaji ni glb, obj, stl, fbx na usdz.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
Toa marejeo ya texture kwa URL, ukitumia picha ya PNG, JPEG au WebP yenye ukubwa wa juu wa 20 MB.
mesh_urlinahitajika
Ainastring
Toa jiometri ya kuweka texture kwa URL katika umbizo la GLB; hakuna umbizo jingine linaloungwa mkono. Chanzo kimoja kinachofaa ni tokeo la jiometri ya image-to-3d lililozalishwa kwa enable_texture=false.
modelsi lazima
Ainaenum
Chaguomsingihitem3dv1.5
hitem3dv1.5scene-portraitv1.5
Toleo la modeli la kutumia kwa kuweka texture. Kazi ya texture iliyopangwa inahitaji modeli ya v1.5.
resolutionsi lazima
Ainaenum
512102415361536pro
Chagua mwonekano wa texture au uache bila kuweka ili kutumia pendekezo la modeli. Kwa scene-portraitv1.5 chaguo pekee ni 1536, ilhali hitem3dv1.5 inatumia 512, 1024, 1536 na 1536pro.
export_formatsi lazima
Ainaenum
Chaguomsingiglb
glbobjstlfbxusdz
Umbizo linalotumika kuhifadhi modeli iliyozalishwa.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Kigeuzi cha ukaguzi wa usalama kwa picha za ingizo: true huhitaji ukaguzi wa usalama kabla uchakataji wa picha kuanza.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
model_mesh
object {url, content_type, file_name, file_size}Faili lililo na modeli ya 3D iliyozalishwa.
thumbnail
object {url, content_type, file_name, file_size} | nullPicha ya onyesho la modeli, inayotolewa inapopatikana.

Miundo zaidi: 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/hitem3d/hi3d/texture.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt