Ruka hadi kwenye maudhui

Hyper3D - Rodin V2.5 - Text to 3D

Unganisha

Kitambulisho cha modeli hyper3d/rodin/v2.5/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ombi hili: $ 0.40 salio za API 400 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Hyper3D Maandishi hadi 3D Pato la 4KHaraka #text-to-3d

Maandishi-hadi-3D yenye Rodin V2.5 katika viwango sita, kutoka kwa kidokezo cha hadi vibambo 1024

Hyper3D · 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 88 / 1024

Maelekezo ya maandishi yanayoongoza uzalishaji wa modeli; ni lazima katika hali ya Text-to-3D.

Ya kina geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
geometry_file_format chaguomsingi glb

Umbizo la faili ya jiometri, huchaguliwa kutoka glb, usdz, fbx, obj, stl; chaguomsingi ni glb.

material chaguomsingi All

Uteuzi wa tokeo la nyenzo: chagua None kwa jiometri isiyo na maandishi, au All kupokea aina zote mbili za nyenzo. Kwa mwangaza halisi wenye nyenzo zinazotegemea fizikia, chagua PBR; kwa mwangaza uliopikwa bila ramani za PBR, chagua Shaded.

texture_mode

Chagua ubora wa maandishi wazi au acha API ichague, ikitumia chaguomsingi inayofaa kiwango.

chaguomsingi Gen-2.5-High

Kiwango cha maelezo ya mesh; kuongeza kiwango huongeza maelezo, lakini Gen-2.5-Minimum huwasha hali ya minimum kiotomatiki na kulazimisha 50K Triangle bila kujali quality_mesh_option. Maelezo zaidi yako katika [nyaraka](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

chaguomsingi Auto

Topolojia na ubora wa mesh, huku idadi ya nyuso inayopatikana ikiainishwa na kiwango: Extreme-Low, Low na Medium huruhusu hadi 1M Triangle; High na Extreme-High huunga mkono 20K Triangle hadi 2M Triangle. Auto hutumia mipangilio hii inayopendekezwa: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Kwa uteuzi wa mwongozo, Quad hupendelea nyuso laini na Triangle hupendelea jiometri yenye maelezo; Hyper3D API hupokea topolojia kama `mesh_mode` (Quad/Raw) na idadi ya nyuso kama `quality_override`.

Mbegu ya hiari ya nasibu yenye masafa ya 0–65535.

Punguza ukubwa wa juu wa modeli iliyozalishwa kwa kutumia ControlNet.

Chaguo za ziada za kutumia, ikihitajika.

POST /run/hyper3d/rodin/v2.5/text-to-3d?wait=20 makadirio → $ 0.40
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 Hyper3D - Rodin V2.5 - Text to 3D

Huzalisha modeli ya 3D kutoka `prompt` inayohitajika yenye hadi herufi 1024. Chagua `tier` kutoka Gen-2.5-Minimum hadi Gen-2.5-Extreme-High (chaguo-msingi High), ukubwa wa mesh katika quads au triangles, na `material` kama PBR au Shaded. Hamisha kama glb, usdz, fbx, obj au stl, na weka `seed` kati ya 0 na 65535.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
promptinahitajika
Ainastring
≤ herufi 1,024
Maelekezo ya maandishi yanayoongoza uzalishaji wa modeli; ni lazima katika hali ya Text-to-3D.
tiersi lazima
Ainaenum
ChaguomsingiGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Kiwango cha maelezo ya mesh; kuongeza kiwango huongeza maelezo, lakini Gen-2.5-Minimum huwasha hali ya minimum kiotomatiki na kulazimisha 50K Triangle bila kujali quality_mesh_option. Maelezo zaidi yako katika [nyaraka](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
seedsi lazima
Ainainteger | null
0 – 65,535
Mbegu ya hiari ya nasibu yenye masafa ya 0–65535.
geometry_file_formatsi lazima
Ainaenum
Chaguomsingiglb
glbusdzfbxobjstl
Umbizo la faili ya jiometri, huchaguliwa kutoka glb, usdz, fbx, obj, stl; chaguomsingi ni glb.
materialsi lazima
Ainaenum
ChaguomsingiAll
PBRShadedAllNone
Uteuzi wa tokeo la nyenzo: chagua None kwa jiometri isiyo na maandishi, au All kupokea aina zote mbili za nyenzo. Kwa mwangaza halisi wenye nyenzo zinazotegemea fizikia, chagua PBR; kwa mwangaza uliopikwa bila ramani za PBR, chagua Shaded.
quality_mesh_optionsi lazima
Ainaenum
ChaguomsingiAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topolojia na ubora wa mesh, huku idadi ya nyuso inayopatikana ikiainishwa na kiwango: Extreme-Low, Low na Medium huruhusu hadi 1M Triangle; High na Extreme-High huunga mkono 20K Triangle hadi 2M Triangle. Auto hutumia mipangilio hii inayopendekezwa: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. Kwa uteuzi wa mwongozo, Quad hupendelea nyuso laini na Triangle hupendelea jiometri yenye maelezo; Hyper3D API hupokea topolojia kama `mesh_mode` (Quad/Raw) na idadi ya nyuso kama `quality_override`.
texture_modesi lazima
Ainaenum
legacyextreme-lowlowmediumhigh
Chagua ubora wa maandishi wazi au acha API ichague, ikitumia chaguomsingi inayofaa kiwango.
enable_creative_modesi lazima
Ainaboolean
Chaguomsingifalse
Hali ya uzalishaji bunifu, sawa na `geometry_instruct_mode` iliyowekwa kuwa `creative` katika Hyper3D API. Kuiwezesha hufanya uzalishaji uwe thabiti zaidi bila kupunguza uthabiti wa tokeo.
hd_texturesi lazima
Ainaboolean
Chaguomsingifalse
Hudhibiti uchakataji wa kina wa baada ya uzalishaji wa maandishi ili kuboresha uaminifu wa kuona.
texture_delightsi lazima
Ainaboolean
Chaguomsingifalse
Huondoa mwangaza na uangazaji uliopikwa kutoka kwenye maandishi yaliyotengenezwa.
is_microsi lazima
Ainaboolean
Chaguomsingifalse
Huongeza maelezo bora ya jiometri kwa kiwango kidogo; huathiri tu wakati `tier="Gen-2.5-Extreme-High"`.
TAPosesi lazima
Ainaboolean
Chaguomsingifalse
Mpangilio wa mkao wa mhusika kwa urahisi wa rigging na uhuishaji katika programu ya 3D: ukiwezeshwa, huzalisha wahusika katika mkao wa T au A.
bbox_conditionsi lazima
Ainaobject
Punguza ukubwa wa juu wa modeli iliyozalishwa kwa kutumia ControlNet.
bbox_condition.widthsi lazima
Ainainteger
Chaguomsingi0
1 – 2,048
Upana wa kizuizi cha kisanduku cha mipaka kwenye mhimili wa x.
bbox_condition.heightsi lazima
Ainainteger
Chaguomsingi0
1 – 2,048
Kimo cha kizuizi cha kisanduku cha mipaka kwenye mhimili wa y.
bbox_condition.lengthsi lazima
Ainainteger
Chaguomsingi0
1 – 2,048
Urefu wa kizuizi cha kisanduku cha mipaka kwenye mhimili wa z.
addonssi lazima
Ainaobject
Chaguo za ziada za kutumia, ikihitajika.
addons.high_packsi lazima
Ainaboolean
Chaguomsingifalse
Uboreshaji wa HighPack: tokeo la Quad lina takriban mara 16 ya idadi ya nyuso iliyoombwa kupitia kigezo cha ubora, na maandishi hutumia mwonekano wa 4K badala ya chaguomsingi ya 2K.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.
inahitajika

Tokeo

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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_meshes": [
      {
        "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
      }
    ],
    "seed": 42,
    "textures": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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 iliyo na kitu cha 3D kilichozalishwa.
model_meshes
array of object {url, content_type, file_name, file_size}Faili za ziada za vitu vya 3D zinazozalishwa na Hyper3D na kurejeshwa pamoja na model_mesh.
seed
integerSeed inayotumika wakati wa uzalishaji.
textures
array of object {url, content_type, file_name, file_size, width, height}Maandishi yaliyotengenezwa kwa kitu cha 3D.

Miundo zaidi: Maandishi hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/hyper3d/rodin/v2.5/text-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt