Siirry sisältöön

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

Integroi

Mallin tunniste hyper3d/rodin/v2.5/fast
# 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/fast?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"

Tämä pyyntö: 0,10 $ 100 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Hyper3D Kuvasta 3D:ksi 4K-tulosteNopea #image-to-3d

Rodin V2.5:n nopea kuvasta 3D-malliksi -versio, joka rajoittuu kolmeen alimpaan tasoon nopeaa prototypointia varten

Hyper3D · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

0 / 1024

Ohjaa generointia tekstillä tai jätä tämä tyhjäksi Image-to-3D-tilassa, jolloin malli muodostaa kehotteen automaattisesti kuvista.

Lisäasetukset 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
image_urls
Pudota tiedosto tai · enintään 5

Mallin generointiin käytettävien lähdekuvien URL-osoitteet. Enintään 5 kuvaa, pakollinen Image-to-3D-tilassa.

geometry_file_format oletus glb

Geometrian tiedostomuoto: glb, usdz, fbx, obj tai stl; oletus on glb.

material oletus Shaded

Tulosteen materiaalivalinta: valitse None, jos haluat geometrian ilman tekstuureja, tai All, jos haluat molemmat materiaaliversiot. Valitse PBR realistiseen valaistukseen fysikaalisesti perustuvilla materiaaleilla tai Shaded tekstuureihin leivottuun valaistukseen ilman PBR-karttoja.

texture_mode

Valitse tekstuurien laatu suoraan tai jätä valinta API:lle, joka käyttää tasolle sopivaa oletusta.

oletus Gen-2.5-Extreme-Low

Generointitaso. Gen-2.5-Minimum pakottaa vähimmäistilan ja 50K Triangle -verkon riippumatta `quality_mesh_option`-arvosta. Tasojen tiedot ovat [Hyper3D-dokumentaatiossa](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

oletus Auto

Valitse laatu ja verkon topologia yhdessä: Quad suosii sileitä pintoja, Triangle geometrisia yksityiskohtia. Nopea päätepiste on tarkoitettu ensisijaisesti testaukseen ja prototyyppien luontiin, ja sen enimmäismäärä on 20K. Käytä tavallista päätepistettä laadukkaampiin verkkoihin: Minimum, Extreme-Low ja Low tukevat enintään arvoa 1M Triangle, ja käytettävissä olevat tahkomäärät riippuvat tasosta. Hyper3D API:ssa `quality_override` määrittää tahkomäärän ja `mesh_mode` arvon Quad/Raw. Auto valitsee suositusasetukset: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Valinnainen satunnaissiemen välillä 0–65535.

Rajoita generoitavan mallin kokoa ControlNetin avulla.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 hinta → 0,10 $
# 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/fast?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"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Hyper3D - Rodin V2.5 - Image to 3D - Fast

Luo 3D-mallin yhdestä viiteen `image_urls`-kuvasta ja valinnaisesta `prompt`-kehotteesta. `tier` rajoittuu tasoihin Minimum, Extreme-Low (oletus) ja Low, ja verkkovaihtoehtojen enimmäismäärä on 20K tahkoa. Materiaalin oletus on Shaded. Vientimuodot ovat glb, usdz, fbx, obj tai stl.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlsvalinnainen images
Tyyppiurl[] · image
≤ 5 kohdetta
Mallin generointiin käytettävien lähdekuvien URL-osoitteet. Enintään 5 kuvaa, pakollinen Image-to-3D-tilassa.
tiervalinnainen
Tyyppienum
OletusGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Generointitaso. Gen-2.5-Minimum pakottaa vähimmäistilan ja 50K Triangle -verkon riippumatta `quality_mesh_option`-arvosta. Tasojen tiedot ovat [Hyper3D-dokumentaatiossa](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptvalinnainen
Tyyppistring
Oletus
≤ 1 024 merkkiä
Ohjaa generointia tekstillä tai jätä tämä tyhjäksi Image-to-3D-tilassa, jolloin malli muodostaa kehotteen automaattisesti kuvista.
use_original_alphavalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, säilytetäänkö syötekuvien läpinäkyvyyskanavat 3D-sisällön generoinnissa.
seedvalinnainen
Tyyppiinteger | null
0 – 65 535
Valinnainen satunnaissiemen välillä 0–65535.
geometry_file_formatvalinnainen
Tyyppienum
Oletusglb
glbusdzfbxobjstl
Geometrian tiedostomuoto: glb, usdz, fbx, obj tai stl; oletus on glb.
materialvalinnainen
Tyyppienum
OletusShaded
PBRShadedAllNone
Tulosteen materiaalivalinta: valitse None, jos haluat geometrian ilman tekstuureja, tai All, jos haluat molemmat materiaaliversiot. Valitse PBR realistiseen valaistukseen fysikaalisesti perustuvilla materiaaleilla tai Shaded tekstuureihin leivottuun valaistukseen ilman PBR-karttoja.
quality_mesh_optionvalinnainen
Tyyppienum
OletusAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Valitse laatu ja verkon topologia yhdessä: Quad suosii sileitä pintoja, Triangle geometrisia yksityiskohtia. Nopea päätepiste on tarkoitettu ensisijaisesti testaukseen ja prototyyppien luontiin, ja sen enimmäismäärä on 20K. Käytä tavallista päätepistettä laadukkaampiin verkkoihin: Minimum, Extreme-Low ja Low tukevat enintään arvoa 1M Triangle, ja käytettävissä olevat tahkomäärät riippuvat tasosta. Hyper3D API:ssa `quality_override` määrittää tahkomäärän ja `mesh_mode` arvon Quad/Raw. Auto valitsee suositusasetukset: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modevalinnainen
Tyyppienum
legacyextreme-lowlowmediumhigh
Valitse tekstuurien laatu suoraan tai jätä valinta API:lle, joka käyttää tasolle sopivaa oletusta.
enable_creative_modevalinnainen
Tyyppiboolean
Oletusfalse
Luova generointitila, joka vastaa Hyper3D API:n `geometry_instruct_mode`-parametrin arvoa `creative`. Sen käyttöönotto parantaa generoinnin toimintavarmuutta heikentämättä tulosteen johdonmukaisuutta.
hd_texturevalinnainen
Tyyppiboolean
Oletusfalse
Ohjaa tekstuurien kehittynyttä jälkikäsittelyä visuaalisen tarkkuuden parantamiseksi.
texture_delightvalinnainen
Tyyppiboolean
Oletusfalse
Poistaa generoiduista tekstuureista niihin leivotun valaistuksen ja kiiltokohdat.
is_microvalinnainen
Tyyppiboolean
Oletusfalse
Lisää hienojakoisia geometrisia yksityiskohtia mikrotasolla. Vaikuttaa vain, kun `tier="Gen-2.5-Extreme-High"`.
TAPosevalinnainen
Tyyppiboolean
Oletusfalse
Hahmon asentoasetus, joka helpottaa luurangon luontia ja animointia 3D-ohjelmistossa: käytössä ollessaan generoi hahmot joko T- tai A-asentoon.
bbox_conditionvalinnainen
Tyyppiobject
Rajoita generoitavan mallin kokoa ControlNetin avulla.
bbox_condition.widthvalinnainen
Tyyppiinteger
Oletus0
1 – 2 048
Rajauslaatikkorajoitteen leveys x-akselilla.
bbox_condition.heightvalinnainen
Tyyppiinteger
Oletus0
1 – 2 048
Rajauslaatikkorajoitteen korkeus y-akselilla.
bbox_condition.lengthvalinnainen
Tyyppiinteger
Oletus0
1 – 2 048
Rajauslaatikkorajoitteen pituus z-akselilla.
preview_rendervalinnainen
Tyyppiboolean
Oletusfalse
Esikatselurenderöinnin valitsin, joka lisää generoitua 3D-mallia esittävän kuvan toimitettaviin mallitiedostoihin.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Suodatusta voi höllentää asettamalla arvoksi false, jos kutsujalla on siihen valtuutus.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
model_mesh
object {url, content_type, file_name, file_size}Generoidun 3D-objektin sisältävä tiedosto.
model_meshes
array of object {url, content_type, file_name, file_size}Hyper3D:n generoimat ylimääräiset 3D-objektitiedostot, jotka palautetaan model_mesh-kentän lisäksi.
seed
integerGeneroinnin aikana käytettävä siemen.
textures
array of object {url, content_type, file_name, file_size, width, height}3D-objektille tuotetut tekstuurit.

Lisää malleja: Kuvasta 3D:ksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/hyper3d/rodin/v2.5/fast.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt