Aqbeż għall-kontenut

Hyper3D - Rodin V2.5 - Image to 3D

Integra

Id tal-mudell hyper3d/rodin/v2.5
# 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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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"

Din it-talba: $0.40 400 krediti tal-API Ħaddmu f’din il-paġna

Ikseb ċavetta API
Hyper3D Immaġni għal 3D Output 4KVeloċi #image-to-3d

Image-to-3D b’Rodin V2.5 li juża sa 5 immaġnijiet ta’ referenza u għażla ta’ livelli ta’ kwalità

Hyper3D · 3D

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

0 / 1024

Gwida għall-ġenerazzjoni bit-test, jew ħalli l-mudell jikseb prompt awtomatikament mill-immaġnijiet billi tħalli dan vojt fil-modalità Image-to-3D.

Avvanzat images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition · addons
image_urls
Waqqa’ fajl, jew · sa 5

URLs tal-immaġnijiet tas-sors, limitati għal 5 immaġnijiet u obbligatorji fil-modalità Image-to-3D, għall-ġenerazzjoni tal-mudell.

geometry_file_format prestabbilit glb

Format tal-fajl tal-ġeometrija, magħżul minn glb, usdz, fbx, obj, stl; prestabbilit għal glb.

material prestabbilit All

Għażla tal-output tal-materjal: agħżel None għall-ġeometrija mingħajr tessuti, jew All biex tirċievi ż-żewġ varjanti tal-materjal. Għal dawl realistiku b’materjali bbażati fiżikament, agħżel PBR; għal dawl baked mingħajr mapep PBR, agħżel Shaded.

texture_mode

Agħżel il-kwalità tat-tessut b’mod espliċitu jew ħalli l-għażla lill-API, li juża prestabbilit adattat għal-livell.

prestabbilit Gen-2.5-High

Livell tad-dettall tal-mesh; iż-żieda fil-livell iżżid id-dettall, iżda Gen-2.5-Minimum jattiva awtomatikament il-modalità minimum u jisforza 50K Triangle irrispettivament minn quality_mesh_option. Dettalji oħra jinsabu fid-[dokumentazzjoni](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

prestabbilit Auto

Topoloġija u kwalità tal-mesh, b’għadd ta’ uċuħ disponibbli determinat mil-livell: Extreme-Low, Low u Medium jippermettu sa 1M Triangle; High u Extreme-High jappoġġjaw minn 20K Triangle sa 2M Triangle. Auto japplika dawn is-settings rakkomandati: 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. Għall-għażla manwali, Quad jippreferi uċuħ lixxi u Triangle jippreferi ġeometrija dettaljata; il-Hyper3D API jirċievi t-topoloġija bħala `mesh_mode` (Quad/Raw) u l-għadd tal-uċuħ bħala `quality_override`.

Seed każwali mhux obbligatorju b’firxa ta’ 0–65535.

Illimita kemm jista’ jkun kbir il-mudell iġġenerat billi tuża ControlNet.

Għażla ta’ add-on mhux obbligatorja, ipprovduta bħala lista jew, għal add-on wieħed biss, bħala valur wieħed.

POST /run/hyper3d/rodin/v2.5?wait=20 kwotazzjoni → $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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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"

Ħaddem din it-talba

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ikseb ċavetta API

Dwar Hyper3D - Rodin V2.5 - Image to 3D

Jibni mudell 3D minn immaġni waħda sa ħames immaġnijiet f’`image_urls`, bi `prompt` fakultattiv sa 1024 karattru. Sitt livelli jvarjaw minn Gen-2.5-Minimum sa Gen-2.5-Extreme-High, b’High bħala prestabbilit. L-għażliet jinkludu l-format tal-ġeometrija (glb, usdz, fbx, obj, stl), `material`, daqsijiet tal-mesh b’quads jew triangoli, `TAPose` għal karattri adattati għar-rigging, u `hd_texture`.

Parametri

Ibgħat jew l-isem kanoniku jew l-isem nattiv, mhux it-tnejn. Ismijiet kanoniċi

IsemTip PrestabbilitPermess Deskrizzjoni
promptmhux obbligatorju
Tipstring
Prestabbilit
≤ 1,024 karattri
Gwida għall-ġenerazzjoni bit-test, jew ħalli l-mudell jikseb prompt awtomatikament mill-immaġnijiet billi tħalli dan vojt fil-modalità Image-to-3D.
image_urlsmhux obbligatorju images
Tipurl[] · image
≤ 5 oġġetti
URLs tal-immaġnijiet tas-sors, limitati għal 5 immaġnijiet u obbligatorji fil-modalità Image-to-3D, għall-ġenerazzjoni tal-mudell.
tiermhux obbligatorju
Tipenum
PrestabbilitGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Livell tad-dettall tal-mesh; iż-żieda fil-livell iżżid id-dettall, iżda Gen-2.5-Minimum jattiva awtomatikament il-modalità minimum u jisforza 50K Triangle irrispettivament minn quality_mesh_option. Dettalji oħra jinsabu fid-[dokumentazzjoni](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphamhux obbligatorju
Tipboolean
Prestabbilitfalse
Jikkontrolla ż-żamma tal-kanali tat-trasparenza tal-immaġni input meta jiġi ġġenerat kontenut 3D.
seedmhux obbligatorju
Tipinteger | null
0 – 65,535
Seed każwali mhux obbligatorju b’firxa ta’ 0–65535.
geometry_file_formatmhux obbligatorju
Tipenum
Prestabbilitglb
glbusdzfbxobjstl
Format tal-fajl tal-ġeometrija, magħżul minn glb, usdz, fbx, obj, stl; prestabbilit għal glb.
materialmhux obbligatorju
Tipenum
PrestabbilitAll
PBRShadedAllNone
Għażla tal-output tal-materjal: agħżel None għall-ġeometrija mingħajr tessuti, jew All biex tirċievi ż-żewġ varjanti tal-materjal. Għal dawl realistiku b’materjali bbażati fiżikament, agħżel PBR; għal dawl baked mingħajr mapep PBR, agħżel Shaded.
quality_mesh_optionmhux obbligatorju
Tipenum
PrestabbilitAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topoloġija u kwalità tal-mesh, b’għadd ta’ uċuħ disponibbli determinat mil-livell: Extreme-Low, Low u Medium jippermettu sa 1M Triangle; High u Extreme-High jappoġġjaw minn 20K Triangle sa 2M Triangle. Auto japplika dawn is-settings rakkomandati: 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. Għall-għażla manwali, Quad jippreferi uċuħ lixxi u Triangle jippreferi ġeometrija dettaljata; il-Hyper3D API jirċievi t-topoloġija bħala `mesh_mode` (Quad/Raw) u l-għadd tal-uċuħ bħala `quality_override`.
texture_modemhux obbligatorju
Tipenum
legacyextreme-lowlowmediumhigh
Agħżel il-kwalità tat-tessut b’mod espliċitu jew ħalli l-għażla lill-API, li juża prestabbilit adattat għal-livell.
enable_creative_modemhux obbligatorju
Tipboolean
Prestabbilitfalse
Modalità ta’ ġenerazzjoni kreattiva, ekwivalenti għal `geometry_instruct_mode` issettjat għal `creative` fil-Hyper3D API. L-attivazzjoni tagħha tagħmel il-ġenerazzjoni aktar robusta mingħajr ma tissagrifika l-konsistenza tal-output.
hd_texturemhux obbligatorju
Tipboolean
Prestabbilitfalse
Jikkontrolla l-ipproċessar avvanzat wara l-ġenerazzjoni tat-tessut biex titjieb il-fedeltà viżiva.
texture_delightmhux obbligatorju
Tipboolean
Prestabbilitfalse
Tneħħi l-illuminazzjoni u l-highlights inkorporati mit-tessuti iġġenerati.
is_micromhux obbligatorju
Tipboolean
Prestabbilitfalse
Iżżid dettall ġeometriku ifjen fuq skala mikro; tidħol fis-seħħ biss meta `tier="Gen-2.5-Extreme-High"`.
TAPosemhux obbligatorju
Tipboolean
Prestabbilitfalse
Issettjar tal-poża tal-karattru għal rigging u animazzjoni aktar faċli f’softwer 3D: l-attivazzjoni tiegħu tiġġenera karattri f’poża T jew A.
bbox_conditionmhux obbligatorju
Tipobject
Illimita kemm jista’ jkun kbir il-mudell iġġenerat billi tuża ControlNet.
bbox_condition.widthmhux obbligatorju
Tipinteger
Prestabbilit0
1 – 2,048
Wisa’ tal-kostrinġiment tal-bounding box tul l-assi x.
bbox_condition.heightmhux obbligatorju
Tipinteger
Prestabbilit0
1 – 2,048
Għoli tal-kostrinġiment tal-bounding box tul l-assi y.
bbox_condition.lengthmhux obbligatorju
Tipinteger
Prestabbilit0
1 – 2,048
Tul tal-kostrinġiment tal-bounding box tul l-assi z.
addonsmhux obbligatorju
Tipobject
Għażla ta’ add-on mhux obbligatorja, ipprovduta bħala lista jew, għal add-on wieħed biss, bħala valur wieħed.
addons.high_packmhux obbligatorju
Tipboolean
Prestabbilitfalse
Titjib HighPack: l-output Quad għandu madwar 16-il darba l-għadd ta’ uċuħ mitlub permezz tal-parametru tal-kwalità, u t-tessuti jużaw riżoluzzjoni 4K minflok il-prestabbilita 2K.
preview_rendermhux obbligatorju
Tipboolean
Prestabbilitfalse
Kontroll tar-rendering ta’ preview li jżid immaġni li turi l-mudell 3D iġġenerat mal-fajls tal-mudell ikkunsinnati.
enable_safety_checkermhux obbligatorju
Tipboolean
Prestabbilittrue
L-iskrinjar jista’ jiġi rilassat billi jiġi ssettjat għal false, sakemm min jagħmel it-talba jkun awtorizzat.
meħtieġ Isem kanoniku, aċċettat ukoll

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5",
  "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": ""
  },
  "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"
  }
}
Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.
L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.
Oqsma tal-output
model_mesh
object {url, content_type, file_name, file_size}Fajl li fih l-oġġett 3D iġġenerat.
model_meshes
array of object {url, content_type, file_name, file_size}Fajls addizzjonali tal-oġġett 3D iġġenerati minn Hyper3D u rritornati flimkien ma’ model_mesh.
seed
integerSeed applikat waqt il-ġenerazzjoni.
textures
array of object {url, content_type, file_name, file_size, width, height}Tessuti prodotti għall-oġġett 3D.

Aktar mudelli: Immaġni għal 3D

Għall-aġenti tal-AI: din il-paġna bħala Markdown tinsab fuq https://doitong.com/mt/developers/models/hyper3d/rodin/v2.5.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt