Saltar al cuntegna

Hyper3D - Rodin V2.5 - Image to 3D

Integrar

ID dal model 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"

Questa dumonda: $0,40 400 credits API · ≈ ₽42,19 Lantschar sin questa pagina

Obtegna ina clav API
Hyper3D Maletg a 3D Output 4KSvelt #image-to-3d

Imatge a 3D amb Rodin V2.5 mitjançant fins a 5 imatges de referència i una selecció de nivells de qualitat

Hyper3D · 3D

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

0 / 1024

Guida la generaziun cun text, u lascha il model deducir automaticamain in prompt dals maletgs laschond quest champ vid en il modus Image-to-3D.

Avanzà 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
Trametta in datoteca u · fin a 5

URL dals maletgs da funtauna, limitads a 5 maletgs e obligatoris en il modus Image-to-3D per generar il model.

geometry_file_format standard glb

Format da datoteca da la geometria, tschernì da glb, usdz, fbx, obj, stl; standardmain glb.

material standard All

Selecziun da l'output dal material: tscherna None per geometria senza texturas u All per survegnir omaduas variantas da material. Per illuminaziun realistica cun materials basads fisicamain, tscherna PBR; per illuminaziun baked senza mapas PBR, tscherna Shaded.

texture_mode

Tscherna explicitamain la qualitad da la textura u lascha la tscherna a l'API, che utilisescha ina valur standard adattada al nivel.

standard Gen-2.5-High

Nivel dal detagl da la rait; augmentar il nivel agiunta detagl, ma Gen-2.5-Minimum activa automaticamain il modus minimum e fixescha 50K Triangle independentamain da quality_mesh_option. Ulteriurs detagls èn en la [documentaziun](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standard Auto

Topologia e qualitad da la rait, cun dumbers da faces disponibels determinads dal nivel: Extreme-Low, Low e Medium permettan fin a 1M Triangle; High ed Extreme-High sustegnan da 20K Triangle fin a 2M Triangle. Auto applitgescha quests parameters recumandads: 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. Per la selecziun manuala preferescha Quad surfatschas glischas e Triangle geometria detagliada; l'API Hyper3D survegn la topologia sco `mesh_mode` (Quad/Raw) e il dumber da faces sco `quality_override`.

Seme da casualisaziun facultativ, cun ina rangada da 0–65535.

Limitescha la grondezza maximala dal model generà cun in ControlNet.

Selecziun d'in additiv facultativ, furnida sco glista u, per in sulet additiv, sco valur singula.

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

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

Construeix un model 3D a partir d'una a cinc imatges a `image_urls`, amb un `prompt` opcional de fins a 1024 caràcters. Sis nivells van de Gen-2.5-Minimum a Gen-2.5-Extreme-High, amb High per defecte. Les opcions inclouen el format de geometria (glb, usdz, fbx, obj, stl), `material`, mides de malla quadrangular o triangular, `TAPose` per a personatges compatibles amb rig i `hd_texture`.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
promptopziunal
Tipstring
Standard
≤ 1 024 caracters
Guida la generaziun cun text, u lascha il model deducir automaticamain in prompt dals maletgs laschond quest champ vid en il modus Image-to-3D.
image_urlsopziunal images
Tipurl[] · image
≤ 5 elements
URL dals maletgs da funtauna, limitads a 5 maletgs e obligatoris en il modus Image-to-3D per generar il model.
tieropziunal
Tipenum
StandardGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Nivel dal detagl da la rait; augmentar il nivel agiunta detagl, ma Gen-2.5-Minimum activa automaticamain il modus minimum e fixescha 50K Triangle independentamain da quality_mesh_option. Ulteriurs detagls èn en la [documentaziun](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphaopziunal
Tipboolean
Standardfalse
Controlla la conservaziun dals chanals da transparenza dal maletg d'input durant la generaziun da cuntegn 3D.
seedopziunal
Tipinteger | null
0 – 65 535
Seme da casualisaziun facultativ, cun ina rangada da 0–65535.
geometry_file_formatopziunal
Tipenum
Standardglb
glbusdzfbxobjstl
Format da datoteca da la geometria, tschernì da glb, usdz, fbx, obj, stl; standardmain glb.
materialopziunal
Tipenum
StandardAll
PBRShadedAllNone
Selecziun da l'output dal material: tscherna None per geometria senza texturas u All per survegnir omaduas variantas da material. Per illuminaziun realistica cun materials basads fisicamain, tscherna PBR; per illuminaziun baked senza mapas PBR, tscherna Shaded.
quality_mesh_optionopziunal
Tipenum
StandardAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topologia e qualitad da la rait, cun dumbers da faces disponibels determinads dal nivel: Extreme-Low, Low e Medium permettan fin a 1M Triangle; High ed Extreme-High sustegnan da 20K Triangle fin a 2M Triangle. Auto applitgescha quests parameters recumandads: 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. Per la selecziun manuala preferescha Quad surfatschas glischas e Triangle geometria detagliada; l'API Hyper3D survegn la topologia sco `mesh_mode` (Quad/Raw) e il dumber da faces sco `quality_override`.
texture_modeopziunal
Tipenum
legacyextreme-lowlowmediumhigh
Tscherna explicitamain la qualitad da la textura u lascha la tscherna a l'API, che utilisescha ina valur standard adattada al nivel.
enable_creative_modeopziunal
Tipboolean
Standardfalse
Modus da generaziun creativ, equivalent a `geometry_instruct_mode` set to `creative` en l'API Hyper3D. L'activaziun fa la generaziun pli robusta senza sacrificar la consistenza da l'output.
hd_textureopziunal
Tipboolean
Standardfalse
Controlla il post-processing avanzà da la textura per meglierar la fidelitad visuala.
texture_delightopziunal
Tipboolean
Standardfalse
Eliminescha illuminaziun e reflexs integrads da las texturas generadas.
is_microopziunal
Tipboolean
Standardfalse
Agiunta detagl geometric pli fin a scala micro; ha effect mo cun `tier="Gen-2.5-Extreme-High"`.
TAPoseopziunal
Tipboolean
Standardfalse
Configuraziun da la posa dal caracter per facilitar rigging e animaziun en software 3D: l'activaziun genera characters en posa T u A.
bbox_conditionopziunal
Tipobject
Limitescha la grondezza maximala dal model generà cun in ControlNet.
bbox_condition.widthopziunal
Tipinteger
Standard0
1 – 2 048
Ladezza da la restricziun dal bounding box sin l'axa x.
bbox_condition.heightopziunal
Tipinteger
Standard0
1 – 2 048
Autezza da la restricziun dal bounding box sin l'axa y.
bbox_condition.lengthopziunal
Tipinteger
Standard0
1 – 2 048
Lunghezza da la restricziun dal bounding box sin l'axa z.
addonsopziunal
Tipobject
Selecziun d'in additiv facultativ, furnida sco glista u, per in sulet additiv, sco valur singula.
addons.high_packopziunal
Tipboolean
Standardfalse
Augmentaziun HighPack: l'output Quad ha circa 16 giadas il dumber da faces dumandà tras il parameter da qualitad, e las texturas utiliseschan resoluziun 4K empè dal standard 2K.
preview_renderopziunal
Tipboolean
Standardfalse
Activa u deactiva il preview render che agiunta in maletg dal model 3D generà a las datotecas dal model furnidas.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
La controlla po vegnir schluccada cun definir false, premess che l'appelant saja autorisà.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
model_mesh
object {url, content_type, file_name, file_size}Datoteca che cuntegna l'object 3D generà.
model_meshes
array of object {url, content_type, file_name, file_size}Datotecas d'objects 3D supplementaras generadas da Hyper3D e restituida supplementarmain a model_mesh.
seed
integerSeed applitgà durant la generaziun.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturas producidas per l'object 3D.

Dapli models: Maletg a 3D

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/hyper3d/rodin/v2.5.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt