Preskoči na vsebino

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

Integracija

ID modela 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"

Ta zahteva: 0,10 $ 100 API kreditov Zaženi na tej strani

Pridobi ključ API
Hyper3D Slika v 3D Izhod 4KHitro #image-to-3d

Hitrejša pretvorba slike v 3D z Rodin V2.5, omejena na tri najnižje stopnje za hitro izdelavo prototipov

Hyper3D · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

0 / 1024

Generiranje usmerite z besedilom ali pustite prazno v načinu Image-to-3D, da model poziv samodejno izpelje iz slik.

Napredno 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
Spustite datoteko ali · do 5

URL-ji izvornih slik, največ 5 slik in obvezno v načinu Image-to-3D, za generiranje modela.

geometry_file_format privzeto glb

Oblika geometrijske datoteke, izbrana med glb, usdz, fbx, obj, stl; privzeto je glb.

material privzeto Shaded

Izbira izhoda materiala: izberite None za geometrijo brez tekstur ali All za obe različici materiala. Za realistično osvetlitev s fizično osnovanimi materiali izberite PBR, za vnaprej izračunano osvetlitev brez zemljevidov PBR pa Shaded.

texture_mode

Kakovost teksture izberite izrecno ali izbiro prepustite API-ju, ki uporabi privzeto vrednost glede na raven.

privzeto Gen-2.5-Extreme-Low

Raven generiranja; Gen-2.5-Minimum vsili minimalni način in mrežo 50K Triangle ne glede na `quality_mesh_option`. Podrobnosti ravni so v [dokumentaciji Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

privzeto Auto

Izberite kakovost skupaj s topologijo mreže: Quad daje prednost gladkim površinam, Triangle pa geometrijskim podrobnostim. Hitra končna točka je namenjena predvsem testiranju in prototipiranju, z omejitvijo 20K; za kakovostnejše mreže uporabite standardno končno točko, kjer Minimum, Extreme-Low in Low podpirajo največ 1M Triangle, razpoložljivo število ploskev pa je odvisno od ravni. V Hyper3D API `quality_override` določa število ploskev, `mesh_mode` pa Quad/Raw. Auto izbere priporočene nastavitve: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Neobvezno naključno seme v razponu 0–65535.

S ControlNet omejite velikost ustvarjenega modela.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 cena → 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"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

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

Iz ene do petih slik v `image_urls` ustvari 3D-model z neobveznim `prompt`. `tier` je omejen na Minimum, Extreme-Low (privzeto) in Low, možnosti mreže pa segajo največ do 20K ploskev. Material je privzeto Shaded. Izhodni formati so glb, usdz, fbx, obj ali stl.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlsneobvezno images
Vrstaurl[] · image
≤ 5 elementov
URL-ji izvornih slik, največ 5 slik in obvezno v načinu Image-to-3D, za generiranje modela.
tierneobvezno
Vrstaenum
PrivzetoGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Raven generiranja; Gen-2.5-Minimum vsili minimalni način in mrežo 50K Triangle ne glede na `quality_mesh_option`. Podrobnosti ravni so v [dokumentaciji Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptneobvezno
Vrstastring
Privzeto
≤ 1024 znakov
Generiranje usmerite z besedilom ali pustite prazno v načinu Image-to-3D, da model poziv samodejno izpelje iz slik.
use_original_alphaneobvezno
Vrstaboolean
Privzetofalse
Nadzira ohranitev kanalov prosojnosti vhodne slike pri generiranju 3D-vsebine.
seedneobvezno
Vrstainteger | null
0 – 65.535
Neobvezno naključno seme v razponu 0–65535.
geometry_file_formatneobvezno
Vrstaenum
Privzetoglb
glbusdzfbxobjstl
Oblika geometrijske datoteke, izbrana med glb, usdz, fbx, obj, stl; privzeto je glb.
materialneobvezno
Vrstaenum
PrivzetoShaded
PBRShadedAllNone
Izbira izhoda materiala: izberite None za geometrijo brez tekstur ali All za obe različici materiala. Za realistično osvetlitev s fizično osnovanimi materiali izberite PBR, za vnaprej izračunano osvetlitev brez zemljevidov PBR pa Shaded.
quality_mesh_optionneobvezno
Vrstaenum
PrivzetoAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Izberite kakovost skupaj s topologijo mreže: Quad daje prednost gladkim površinam, Triangle pa geometrijskim podrobnostim. Hitra končna točka je namenjena predvsem testiranju in prototipiranju, z omejitvijo 20K; za kakovostnejše mreže uporabite standardno končno točko, kjer Minimum, Extreme-Low in Low podpirajo največ 1M Triangle, razpoložljivo število ploskev pa je odvisno od ravni. V Hyper3D API `quality_override` določa število ploskev, `mesh_mode` pa Quad/Raw. Auto izbere priporočene nastavitve: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeneobvezno
Vrstaenum
legacyextreme-lowlowmediumhigh
Kakovost teksture izberite izrecno ali izbiro prepustite API-ju, ki uporabi privzeto vrednost glede na raven.
enable_creative_modeneobvezno
Vrstaboolean
Privzetofalse
Ustvarjalni način generiranja, enakovreden nastavitvi `geometry_instruct_mode` na `creative` v Hyper3D API. Omogočanje poveča robustnost generiranja brez zmanjšanja doslednosti izhoda.
hd_textureneobvezno
Vrstaboolean
Privzetofalse
Nadzira napredno naknadno obdelavo tekstur za izboljšanje vizualne zvestobe.
texture_delightneobvezno
Vrstaboolean
Privzetofalse
Iz ustvarjenih tekstur odstrani vnaprej vgrajeno osvetlitev in poudarke.
is_microneobvezno
Vrstaboolean
Privzetofalse
Doda natančnejše geometrijske podrobnosti na mikro ravni; učinkuje samo, ko je `tier="Gen-2.5-Extreme-High"`.
TAPoseneobvezno
Vrstaboolean
Privzetofalse
Nastavitev poze lika za lažje pripravljanje okostja in animacijo v 3D-programski opremi: omogočanje ustvari like v pozi T ali A.
bbox_conditionneobvezno
Vrstaobject
S ControlNet omejite velikost ustvarjenega modela.
bbox_condition.widthneobvezno
Vrstainteger
Privzeto0
1 – 2048
Omejitev širine omejevalnega okvirja vzdolž osi x.
bbox_condition.heightneobvezno
Vrstainteger
Privzeto0
1 – 2048
Omejitev višine omejevalnega okvirja vzdolž osi y.
bbox_condition.lengthneobvezno
Vrstainteger
Privzeto0
1 – 2048
Omejitev dolžine omejevalnega okvirja vzdolž osi z.
preview_renderneobvezno
Vrstaboolean
Privzetofalse
Preklop predogleda upodabljanja, ki dostavljenim datotekam modela doda sliko ustvarjenega 3D-modela.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Preverjanje je mogoče omiliti z nastavitvijo false, če je klicatelj pooblaščen.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
model_mesh
object {url, content_type, file_name, file_size}Datoteka z ustvarjenim 3D-objektom.
model_meshes
array of object {url, content_type, file_name, file_size}Dodatne datoteke 3D-objekta, ki jih ustvari Hyper3D in vrne poleg model_mesh.
seed
integerSeme, uporabljeno med generiranjem.
textures
array of object {url, content_type, file_name, file_size, width, height}Teksture, ustvarjene za 3D-objekt.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/hyper3d/rodin/v2.5/fast.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt