Ruka hadi kwenye maudhui

Tripo H3.1 Image to 3D

Unganisha

Kitambulisho cha modeli tripo3d/h3.1/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/tripo3d/h3.1/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"

Faili kama mfano: $ 0.30 salio za API 300 · ≈ ₽ 32.27 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Tripo Picha hadi 3D #3d#image-to-3d#3d-generation#tripo

Utengenezaji wa 3D kutoka picha moja wenye nyenzo za PBR, mesh za quad na udhibiti wa idadi ya faces

Tripo · 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

URL ya picha ya ingizo inayotumika kuunda modeli ya 3D.

texture_quality chaguomsingi standard

Mpangilio wa ubora wa texture; kuchagua 'detailed' huongeza mwonekano wa texture.

geometry_quality chaguomsingi standard

Mpangilio wa ubora wa jiometri.

Ya kina texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment chaguomsingi original_image

Rejeleo la upangaji wa texture: tumia 'geometry' kwa jiometri iliyozalishwa au 'original_image' kwa picha ya ingizo.

orientation chaguomsingi default

Mwelekeo wa modeli; 'align_image' huizungusha kiotomatiki ili ilingane na picha ya ingizo.

Lengo mahususi la idadi ya nyuso kwa uzalishaji wa mesh, linalobatilisha uteuzi wa idadi unaobadilika wa modeli linapotolewa.

Seed inayotumika kufanya uzalishaji wa jiometri uweze kurudiwa.

Seed inayotumika kufanya uzalishaji wa texture uweze kurudiwa.

POST /run/tripo3d/h3.1/image-to-3d?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/tripo3d/h3.1/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"

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 Tripo H3.1 Image to 3D

Hujenga modeli ya 3D kutoka kwa picha moja iliyo kwenye `image_url`. Chaguo ni pamoja na `face_limit` (1,000 hadi 2,000,000), `texture`, `pbr`, `texture_quality` na `geometry_quality` za kawaida au za kina, topolojia ya `quad`, `auto_size` na `orientation`. Tokeo linajumuisha kurenda ya onyesho la kukagua na kitambulisho cha kazi kwa rigging ya baadaye.

Vigezo

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

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
URL ya picha ya ingizo inayotumika kuunda modeli ya 3D.
face_limitsi lazima
Ainainteger | null
1,000 – 2,000,000
Lengo mahususi la idadi ya nyuso kwa uzalishaji wa mesh, linalobatilisha uteuzi wa idadi unaobadilika wa modeli linapotolewa.
texturesi lazima
Ainaboolean
Chaguomsingitrue
Hudhibiti ikiwa modeli itapokea maumbo yaliyotengenezwa.
pbrsi lazima
Ainaboolean
Chaguomsingitrue
Washa nyenzo za PBR (Physically Based Rendering), ambayo pia huwasha uzalishaji wa texture ikiwa ni true.
model_seedsi lazima
Ainainteger | null
Seed inayotumika kufanya uzalishaji wa jiometri uweze kurudiwa.
texture_seedsi lazima
Ainainteger | null
Seed inayotumika kufanya uzalishaji wa texture uweze kurudiwa.
texture_qualitysi lazima
Ainaenum
Chaguomsingistandard
standarddetailed
Mpangilio wa ubora wa texture; kuchagua 'detailed' huongeza mwonekano wa texture.
geometry_qualitysi lazima
Ainaenum
Chaguomsingistandard
standarddetailed
Mpangilio wa ubora wa jiometri.
texture_alignmentsi lazima
Ainaenum
Chaguomsingioriginal_image
original_imagegeometry
Rejeleo la upangaji wa texture: tumia 'geometry' kwa jiometri iliyozalishwa au 'original_image' kwa picha ya ingizo.
auto_sizesi lazima
Ainaboolean
Chaguomsingifalse
Upimaji wa kiotomatiki ili kuipa modeli vipimo vya ulimwengu halisi vinavyopimwa kwa mita.
orientationsi lazima
Ainaenum
Chaguomsingidefault
defaultalign_image
Mwelekeo wa modeli; 'align_image' huizungusha kiotomatiki ili ilingane na picha ya ingizo.
quadsi lazima
Ainaboolean
Chaguomsingifalse
Chagua kati ya nyuso za pembetatu na quad zenye pande 4 kwa kuwasha topolojia ya quad. Kwa matokeo ya quad, faili la FBX hurudishwa Tripo inapotoa data kama baiti za FBX.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.
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": "tripo3d/h3.1/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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    },
    "model_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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 la GLB au FBX lenye modeli ya 3D iliyozalishwa, ambapo umbizo huamuliwa na kile Tripo inachozalisha.
model_urls
object {glb, fbx, base_model, pbr_model}URL zinazoelekeza kwenye matoleo mbadala ya modeli ya 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullHakikisho lililorekodiwa linaloonyesha modeli ya 3D iliyozalishwa.
task_id
string | nullKitambulisho cha kazi cha Tripo kinachoweza kutumika tena, kinachotambulisha modeli iliyozalishwa kwa rig au rig-check na kuruhusu operesheni hizo bila kupakia modeli nyingine.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/tripo3d/h3.1/image-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt