Aqbeż għall-kontenut

Hyper3D - Rodin V2.5 - Text to 3D

Integra

Id tal-mudell 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Ikseb ċavetta API
Hyper3D Test għal 3D Output 4KVeloċi #text-to-3d

Text-to-3D b’Rodin V2.5 f’sitt livelli, minn prompt sa 1024 karattru

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.

•meħtieġ 88 / 1024

Istruzzjonijiet testwali li jiggwidaw il-ġenerazzjoni tal-mudell; obbligatorji fil-modalità Text-to-3D.

Avvanzat 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 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żliet addizzjonali li għandhom jiġu applikati, jekk meħtieġ.

POST /run/hyper3d/rodin/v2.5/text-to-3d?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.ru/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.ru/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 - Text to 3D

Jiġġenera mudell 3D minn `prompt` meħtieġ sa 1024 karattru. Agħżel `tier` minn Gen-2.5-Minimum sa Gen-2.5-Extreme-High (High prestabbilit), daqs tal-mesh b’quads jew triangoli, u `material` bħal PBR jew Shaded. Esporta bħala glb, usdz, fbx, obj jew stl, u ssettja `seed` bejn 0 u 65535.

Parametri

IsemTip PrestabbilitPermess Deskrizzjoni
promptmeħtieġ
Tipstring
≤ 1,024 karattri
Istruzzjonijiet testwali li jiggwidaw il-ġenerazzjoni tal-mudell; obbligatorji fil-modalità Text-to-3D.
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).
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żliet addizzjonali li għandhom jiġu applikati, jekk meħtieġ.
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.
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ġ

Output

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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: Test 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/text-to-3d.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt