Op den Inhalt sprangen

Hyper3D - Rodin V2.5 - Image to 3D

Integréieren

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

Dës Ufro: 0,40 $ 400 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Hyper3D Bild zu 3D 4K-OutputSchnell #image-to-3d

Bild-zu-3D mat Rodin V2.5, bis zu 5 Referenzbiller an enger Wiel vu Qualitéitsstufen

Hyper3D · 3D

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

0 / 1024

Leet d'Generatioun mat Text un, oder loosst de Modell de Prompt automatesch aus de Biller ofleeden, andeems Dir dëst am Image-to-3D-Modus eidel léisst.

Erweidert 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
Fichier erofzéien, oder · bis zu 5

URLen vun de Quellbiller, limitéiert op 5 Biller an obligatoresch am Image-to-3D-Modus, fir de Modell ze generéieren.

geometry_file_format Standard glb

Geometrie-Dateiformat, ausgewielt aus glb, usdz, fbx, obj, stl; Standard ass glb.

material Standard All

Auswiel vum Material-Output: Wielt None fir Geometrie ouni Texturen oder All, fir béid Materialvarianten ze kréien. Fir realistesch Beliichtung mat physikalesch baséierte Materialien, wielt PBR; fir gebake Beliichtung ouni PBR-Maps, wielt Shaded.

texture_mode

Wielt d'Texturqualitéit explizit oder iwwerloosst d'Auswiel der API, déi e Standard passend zum Niveau benotzt.

Standard Gen-2.5-High

Mesh-Detailniveau; d'Erhéijung füügt Detailer bäi, awer Gen-2.5-Minimum aktivéiert automatesch de Minimum-Modus a forcéiert 50K Triangle onofhängeg vun quality_mesh_option. Weider Detailer fannt Dir an der [Dokumentatioun](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

Standard Auto

Mesh-Topologie a Qualitéit, mat verfügbare Flächenzuelen, déi vum Niveau ofhänken: Extreme-Low, Low a Medium erlaben bis zu 1M Triangle; High an Extreme-High ënnerstëtzen 20K Triangle bis 2M Triangle. Auto applizéiert dës recommandéiert Astellungen: 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. Bei manueller Auswiel favoriséiert Quad glat Flächen an Triangle detailléiert Geometrie; d'Hyper3D API kritt d'Topologie als `mesh_mode` (Quad/Raw) an d'Flächenzuel als `quality_override`.

Optionalen zoufällege Seed am Beräich vun 0–65535.

Limitéiert mat engem ControlNet, wéi grouss de generéierte Modell ka ginn.

Optional Add-on-Auswiel, als Lëscht oder, fir nëmmen een Add-on, als eenzele Wäert.

POST /run/hyper3d/rodin/v2.5?wait=20 Präis → 0,40 $
# 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?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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

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

Erstellt e 3D-Modell aus engem bis fënnef Biller an `image_urls`, mat engem fakultative `prompt` vu bis zu 1024 Zeechen. Sechs Stufe lafe vu Gen-2.5-Minimum bis Gen-2.5-Extreme-High, par défaut High. Optioune sinn Geometrieformater (glb, usdz, fbx, obj, stl), `material`, Quad- oder Triangle-Mesh-Gréissten, `TAPose` fir rig-frëndlech Charakteren an `hd_texture`.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptoptional
Typstring
Standard
≤ 1.024 Zeechen
Leet d'Generatioun mat Text un, oder loosst de Modell de Prompt automatesch aus de Biller ofleeden, andeems Dir dëst am Image-to-3D-Modus eidel léisst.
image_urlsoptional images
Typurl[] · image
≤ 5 Elementer
URLen vun de Quellbiller, limitéiert op 5 Biller an obligatoresch am Image-to-3D-Modus, fir de Modell ze generéieren.
tieroptional
Typenum
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
Mesh-Detailniveau; d'Erhéijung füügt Detailer bäi, awer Gen-2.5-Minimum aktivéiert automatesch de Minimum-Modus a forcéiert 50K Triangle onofhängeg vun quality_mesh_option. Weider Detailer fannt Dir an der [Dokumentatioun](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphaoptional
Typboolean
Standardfalse
Kontrolléiert d'Iwwernam vun den Transparenzkanäl vun den Input-Biller bei der Generatioun vun 3D-Inhalt.
seedoptional
Typinteger | null
0 – 65.535
Optionalen zoufällege Seed am Beräich vun 0–65535.
geometry_file_formatoptional
Typenum
Standardglb
glbusdzfbxobjstl
Geometrie-Dateiformat, ausgewielt aus glb, usdz, fbx, obj, stl; Standard ass glb.
materialoptional
Typenum
StandardAll
PBRShadedAllNone
Auswiel vum Material-Output: Wielt None fir Geometrie ouni Texturen oder All, fir béid Materialvarianten ze kréien. Fir realistesch Beliichtung mat physikalesch baséierte Materialien, wielt PBR; fir gebake Beliichtung ouni PBR-Maps, wielt Shaded.
quality_mesh_optionoptional
Typenum
StandardAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh-Topologie a Qualitéit, mat verfügbare Flächenzuelen, déi vum Niveau ofhänken: Extreme-Low, Low a Medium erlaben bis zu 1M Triangle; High an Extreme-High ënnerstëtzen 20K Triangle bis 2M Triangle. Auto applizéiert dës recommandéiert Astellungen: 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. Bei manueller Auswiel favoriséiert Quad glat Flächen an Triangle detailléiert Geometrie; d'Hyper3D API kritt d'Topologie als `mesh_mode` (Quad/Raw) an d'Flächenzuel als `quality_override`.
texture_modeoptional
Typenum
legacyextreme-lowlowmediumhigh
Wielt d'Texturqualitéit explizit oder iwwerloosst d'Auswiel der API, déi e Standard passend zum Niveau benotzt.
enable_creative_modeoptional
Typboolean
Standardfalse
Kreative Generatiounsmodus, entspriechend `geometry_instruct_mode` op `creative` an der Hyper3D API. D'Aktivéierung mécht d'Generatioun méi robust, ouni d'Konsistenz vum Output ze beeinträchtegen.
hd_textureoptional
Typboolean
Standardfalse
Kontrolléiert fortgeschratt Textur-Post-Processing fir d'visuell Fidelitéit ze verbesseren.
texture_delightoptional
Typboolean
Standardfalse
Ewechhuele vu gebakener Beliichtung a Glanz aus de generéierten Texturen.
is_microoptional
Typboolean
Standardfalse
Füügt méi feine geometreschen Detail op Mikro-Skala bäi; wierkt nëmme wann `tier="Gen-2.5-Extreme-High"`.
TAPoseoptional
Typboolean
Standardfalse
Charakterpose fir méi einfach Rigging an Animatioun an 3D-Software: d'Aktivéierung generéiert Charakteren an T-Pose oder A-Pose.
bbox_conditionoptional
Typobject
Limitéiert mat engem ControlNet, wéi grouss de generéierte Modell ka ginn.
bbox_condition.widthoptional
Typinteger
Standard0
1 – 2.048
Breet vun der Bounding-Box-Beschränkung op der x-Achs.
bbox_condition.heightoptional
Typinteger
Standard0
1 – 2.048
Héicht vun der Bounding-Box-Beschränkung op der y-Achs.
bbox_condition.lengthoptional
Typinteger
Standard0
1 – 2.048
Längt vun der Bounding-Box-Beschränkung op der z-Achs.
addonsoptional
Typobject
Optional Add-on-Auswiel, als Lëscht oder, fir nëmmen een Add-on, als eenzele Wäert.
addons.high_packoptional
Typboolean
Standardfalse
HighPack-Verbesserung: Quad-Output huet ongeféier 16 Mol sou vill Flächen wéi iwwer de Qualitéitsparameter ugefrot, an d'Texture benotzen 4K-Opléisung amplaz vum Standard 2K.
preview_renderoptional
Typboolean
Standardfalse
Preview-Render-Schalter, deen e Bild vum generéierten 3D-Modell zu de geliwwerte Modell-Dateie bäifüügt.
enable_safety_checkeroptional
Typboolean
Standardtrue
D'Kontroll kann duerch false gelackert ginn, wann den Uruffer autoriséiert ass.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
model_mesh
object {url, content_type, file_name, file_size}Datei mat dem generéierten 3D-Objet.
model_meshes
array of object {url, content_type, file_name, file_size}Zousätzlech 3D-Objet-Dateien, déi vun Hyper3D generéiert an zousätzlech zu model_mesh zeréckgeliwwert ginn.
seed
integerSeed, deen während der Generatioun applizéiert gëtt.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturen, déi fir den 3D-Objet produzéiert goufen.

Méi Modeller: Bild zu 3D

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/hyper3d/rodin/v2.5.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt