Op den Inhalt sprangen

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

Integréieren

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

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

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

Méi séier Rodin V2.5 Bild-zu-3D, limitéiert op déi dräi niddregst Stufe fir séier Prototyping

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

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-Extreme-Low

Generatiounsniveau; Gen-2.5-Minimum forcéiert de Minimum-Modus an e 50K-Triangle-Mesh onofhängeg vun `quality_mesh_option`. Detailer zu den Niveaue sinn an der [Hyper3D-Dokumentatioun](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) verfügbar.

Standard Auto

Wielt d'Qualitéit zesumme mat der Mesh-Topologie: Quad favoriséiert glat Flächen, Triangle geometreschen Detail. Den schnellen Endpunkt ass haaptsächlech fir Testen a Prototyping geduecht, mat enger Limitt vun 20K; benotzt de Standard-Endpunkt fir méi qualitativ Meshes, wou Minimum, Extreme-Low a Low bis zu 1M Triangle ënnerstëtzen, mat Flächenzuelen, déi vum Niveau ofhänken. An der Hyper3D API spezifizéiert `quality_override` d'Flächenzuel, `mesh_mode` Quad/Raw. Auto wielt d'recommandéiert Astellungen: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

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

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

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

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

Erstellt e 3D-Modell aus engem bis fënnef Biller an `image_urls`, mat engem fakultative `prompt`. `tier` ass op Minimum, Extreme-Low (par défaut) a Low limitéiert, an d’Mesh-Optioune ginn bis 20K Flächen. D’Material ass par défaut Shaded. Ausgabformater si glb, usdz, fbx, obj oder stl.

Parameteren

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

NummTyp StandardErlaabt Beschreiwung
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-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Generatiounsniveau; Gen-2.5-Minimum forcéiert de Minimum-Modus an e 50K-Triangle-Mesh onofhängeg vun `quality_mesh_option`. Detailer zu den Niveaue sinn an der [Hyper3D-Dokumentatioun](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) verfügbar.
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.
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
StandardShaded
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
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Wielt d'Qualitéit zesumme mat der Mesh-Topologie: Quad favoriséiert glat Flächen, Triangle geometreschen Detail. Den schnellen Endpunkt ass haaptsächlech fir Testen a Prototyping geduecht, mat enger Limitt vun 20K; benotzt de Standard-Endpunkt fir méi qualitativ Meshes, wou Minimum, Extreme-Low a Low bis zu 1M Triangle ënnerstëtzen, mat Flächenzuelen, déi vum Niveau ofhänken. An der Hyper3D API spezifizéiert `quality_override` d'Flächenzuel, `mesh_mode` Quad/Raw. Auto wielt d'recommandéiert Astellungen: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
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.
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/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"
  }
}
Ä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/fast.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt