Preskoči na vsebino

Hyper3D - Rodin V2.5 - Image to 3D

Integracija

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

Ta zahteva: 0,40 $ 400 API kreditov · ≈ 42,19 ₽ Zaženi na tej strani

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

Pretvorba slike v 3D z Rodin V2.5 z največ 5 referenčnimi slikami in izbiro stopenj kakovosti

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 · addons
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 All

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-High

Raven podrobnosti mreže; višja raven doda podrobnosti, vendar Gen-2.5-Minimum samodejno aktivira minimalni način in vsili 50K Triangle ne glede na quality_mesh_option. Več podrobnosti je v [dokumentaciji](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

privzeto Auto

Topologija in kakovost mreže; razpoložljivo število ploskev določa raven: Extreme-Low, Low in Medium omogočajo največ 1M Triangle; High in Extreme-High podpirata od 20K Triangle do 2M Triangle. Auto uporabi priporočene nastavitve: 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. Pri ročni izbiri Quad daje prednost gladkim površinam, Triangle pa podrobni geometriji; Hyper3D API prejme topologijo kot `mesh_mode` (Quad/Raw), število ploskev pa kot `quality_override`.

Neobvezno naključno seme v razponu 0–65535.

S ControlNet omejite velikost ustvarjenega modela.

Neobvezna izbira dodatkov, podana kot seznam ali kot ena sama vrednost za en dodatek.

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

Iz ene do petih slik v `image_urls` izdela 3D-model, neobvezni `prompt` pa lahko vsebuje do 1024 znakov. Šest stopenj sega od Gen-2.5-Minimum do Gen-2.5-Extreme-High, privzeta je High. Možnosti vključujejo format geometrije (glb, usdz, fbx, obj, stl), `material`, velikosti štirikotnih ali trikotnih mrež, `TAPose` za like, primerne za opremljanje, in `hd_texture`.

Parametri

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

ImeVrsta PrivzetoDovoljeno Opis
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.
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-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Raven podrobnosti mreže; višja raven doda podrobnosti, vendar Gen-2.5-Minimum samodejno aktivira minimalni način in vsili 50K Triangle ne glede na quality_mesh_option. Več podrobnosti je v [dokumentaciji](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
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
PrivzetoAll
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
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topologija in kakovost mreže; razpoložljivo število ploskev določa raven: Extreme-Low, Low in Medium omogočajo največ 1M Triangle; High in Extreme-High podpirata od 20K Triangle do 2M Triangle. Auto uporabi priporočene nastavitve: 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. Pri ročni izbiri Quad daje prednost gladkim površinam, Triangle pa podrobni geometriji; Hyper3D API prejme topologijo kot `mesh_mode` (Quad/Raw), število ploskev pa kot `quality_override`.
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.
addonsneobvezno
Vrstaobject
Neobvezna izbira dodatkov, podana kot seznam ali kot ena sama vrednost za en dodatek.
addons.high_packneobvezno
Vrstaboolean
Privzetofalse
Izboljšava HighPack: izhod Quad ima približno 16-krat več ploskev, kot jih zahteva parameter kakovosti, teksture pa uporabljajo ločljivost 4K namesto privzete 2K.
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",
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt