Neidio i'r cynnwys

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

Integreiddio

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

Y cais hwn: $0.10 100 o gredydau API Ei redeg ar y dudalen hon

Cael allwedd API
Hyper3D Delwedd i 3D Allbwn 4KCyflym #image-to-3d

Rodin V2.5 delwedd-i-3D cyflymach wedi'i gyfyngu i'r tair haen isaf ar gyfer prototeipio cyflym

Hyper3D · 3D

Mae eich canlyniad cyntaf yn mynd yma

Adeiladwch gais isod a'i redeg gyda'ch allwedd API. Mae allbynnau'n cael eu copïo i'n storio, wedi'u cadw am byth neu am 7 diwrnod am ddim.

Adeiladu cais

Cynhyrchir rheolyddion o sgema'r model. Mae'r cod a'r pris yn diweddaru wrth i chi eu newid.

0 / 1024

Arwain y cynhyrchu â thestun, neu adael i'r model ddeillio anogiad yn awtomatig o'r delweddau drwy adael hwn yn wag yn Image-to-3D.

Uwch 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
Gollyngwch ffeil, neu · hyd at 5

URLau delwedd ffynhonnell, wedi'u cyfyngu i 5 delwedd ac yn orfodol yn Image-to-3D, ar gyfer cynhyrchu'r model.

geometry_file_format rhagosodedig glb

Fformat ffeil geometreg, wedi'i ddewis o glb, usdz, fbx, obj, stl; glb yw'r rhagosodiad.

material rhagosodedig Shaded

Dewis allbwn deunydd: dewiswch None ar gyfer geometreg heb weadau, neu All i dderbyn y ddau amrywiad deunydd. Ar gyfer goleuo realistig â deunyddiau seiliedig yn gorfforol, dewiswch PBR; ar gyfer goleuo wedi'i bobi heb fapiau PBR, dewiswch Shaded.

texture_mode

Dewiswch ansawdd y gwead yn benodol neu gadewch y dewis i'r API, sy'n defnyddio rhagosodiad addas i'r haen.

rhagosodedig Gen-2.5-Extreme-Low

Haen gynhyrchu; mae Gen-2.5-Minimum yn gorfodi modd minimum a rhwyll 50K Triangle waeth beth fo `quality_mesh_option`. Mae manylion yr haenau ar gael yn [nogfennaeth Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

rhagosodedig Auto

Dewiswch ansawdd ynghyd â thopoleg y rhwyll: mae Quad yn ffafrio arwynebau llyfn, tra bod Triangle yn ffafrio manylder geometrig. Bwriedir y diweddbwynt cyflym yn bennaf ar gyfer profi a phrototeipio, gyda therfyn 20K; defnyddiwch y diweddbwynt safonol ar gyfer rhwyllau o ansawdd uwch, lle mae Minimum, Extreme-Low a Low yn cefnogi hyd at 1M Triangle, gyda nifer yr wynebau sydd ar gael yn dibynnu ar yr haen. Yn yr Hyper3D API, mae `quality_override` yn pennu nifer yr wynebau, tra bod `mesh_mode` yn pennu Quad/Raw. Mae Auto yn dewis y gosodiadau argymelledig: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Hadau hapddewisol gydag ystod o 0–65535.

Cyfyngu ar faint y gall y model a gynhyrchir fod gan ddefnyddio ControlNet.

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

Rhedeg y cais hwn

Mae'ch allwedd yn aros yn y porwr hwn: caiff ei hanfon at Doitong API yn unig a'i chadw (localStorage) dim ond os ticiwch Cofio. Cael allwedd API

Ynglŷn â Hyper3D - Rodin V2.5 - Image to 3D - Fast

Yn creu model 3D o un i bum delwedd yn `image_urls`, gyda `prompt` dewisol. Mae `tier` wedi'i gyfyngu i Minimum, Extreme-Low (diofyn) a Low, ac mae opsiynau'r rhwyll yn cyrraedd 20K wyneb ar y mwyaf. Shaded yw'r deunydd diofyn. Fformatau allbwn: glb, usdz, fbx, obj neu stl.

Paramedrau

Anfonwch naill ai'r enw canonaidd neu'r enw brodorol, nid y ddau. Enwau canonaidd

EnwMath RhagosodedigCaniateir Disgrifiad
image_urlsdewisol images
Mathurl[] · image
≤ 5 eitem
URLau delwedd ffynhonnell, wedi'u cyfyngu i 5 delwedd ac yn orfodol yn Image-to-3D, ar gyfer cynhyrchu'r model.
tierdewisol
Mathenum
RhagosodedigGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Haen gynhyrchu; mae Gen-2.5-Minimum yn gorfodi modd minimum a rhwyll 50K Triangle waeth beth fo `quality_mesh_option`. Mae manylion yr haenau ar gael yn [nogfennaeth Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptdewisol
Mathstring
Rhagosodedig
≤ 1,024 nod
Arwain y cynhyrchu â thestun, neu adael i'r model ddeillio anogiad yn awtomatig o'r delweddau drwy adael hwn yn wag yn Image-to-3D.
use_original_alphadewisol
Mathboolean
Rhagosodedigfalse
Rheoli cadw sianeli tryloywder delweddau mewnbwn wrth gynhyrchu cynnwys 3D.
seeddewisol
Mathinteger | null
0 – 65,535
Hadau hapddewisol gydag ystod o 0–65535.
geometry_file_formatdewisol
Mathenum
Rhagosodedigglb
glbusdzfbxobjstl
Fformat ffeil geometreg, wedi'i ddewis o glb, usdz, fbx, obj, stl; glb yw'r rhagosodiad.
materialdewisol
Mathenum
RhagosodedigShaded
PBRShadedAllNone
Dewis allbwn deunydd: dewiswch None ar gyfer geometreg heb weadau, neu All i dderbyn y ddau amrywiad deunydd. Ar gyfer goleuo realistig â deunyddiau seiliedig yn gorfforol, dewiswch PBR; ar gyfer goleuo wedi'i bobi heb fapiau PBR, dewiswch Shaded.
quality_mesh_optiondewisol
Mathenum
RhagosodedigAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Dewiswch ansawdd ynghyd â thopoleg y rhwyll: mae Quad yn ffafrio arwynebau llyfn, tra bod Triangle yn ffafrio manylder geometrig. Bwriedir y diweddbwynt cyflym yn bennaf ar gyfer profi a phrototeipio, gyda therfyn 20K; defnyddiwch y diweddbwynt safonol ar gyfer rhwyllau o ansawdd uwch, lle mae Minimum, Extreme-Low a Low yn cefnogi hyd at 1M Triangle, gyda nifer yr wynebau sydd ar gael yn dibynnu ar yr haen. Yn yr Hyper3D API, mae `quality_override` yn pennu nifer yr wynebau, tra bod `mesh_mode` yn pennu Quad/Raw. Mae Auto yn dewis y gosodiadau argymelledig: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modedewisol
Mathenum
legacyextreme-lowlowmediumhigh
Dewiswch ansawdd y gwead yn benodol neu gadewch y dewis i'r API, sy'n defnyddio rhagosodiad addas i'r haen.
enable_creative_modedewisol
Mathboolean
Rhagosodedigfalse
Modd cynhyrchu creadigol, sy'n cyfateb i `geometry_instruct_mode` wedi'i osod i `creative` yn yr Hyper3D API. Mae ei alluogi yn gwneud y cynhyrchu'n fwy cadarn heb aberthu cysondeb yr allbwn.
hd_texturedewisol
Mathboolean
Rhagosodedigfalse
Rheoli ôl-brosesu gwead uwch i wella ffyddlondeb gweledol.
texture_delightdewisol
Mathboolean
Rhagosodedigfalse
Tynnu goleuo a sbotoleuadau wedi'u pobi allan o weadau a gynhyrchwyd.
is_microdewisol
Mathboolean
Rhagosodedigfalse
Ychwanegu manylder geometrig mân ar raddfa ficrô; dim ond pan fo `tier="Gen-2.5-Extreme-High"` y daw i rym.
TAPosedewisol
Mathboolean
Rhagosodedigfalse
Gosodiad ystum cymeriad ar gyfer rigio ac animeiddio haws mewn meddalwedd 3D: mae ei alluogi yn cynhyrchu cymeriadau mewn ystum T neu A.
bbox_conditiondewisol
Mathobject
Cyfyngu ar faint y gall y model a gynhyrchir fod gan ddefnyddio ControlNet.
bbox_condition.widthdewisol
Mathinteger
Rhagosodedig0
1 – 2,048
Cyfyngiad lled y blwch terfyn ar hyd yr echelin x.
bbox_condition.heightdewisol
Mathinteger
Rhagosodedig0
1 – 2,048
Cyfyngiad uchder y blwch terfyn ar hyd yr echelin y.
bbox_condition.lengthdewisol
Mathinteger
Rhagosodedig0
1 – 2,048
Cyfyngiad hyd y blwch terfyn ar hyd yr echelin z.
preview_renderdewisol
Mathboolean
Rhagosodedigfalse
Toglo rendro rhagolwg sy'n ychwanegu delwedd yn dangos y model 3D a gynhyrchwyd at y ffeiliau model a ddarperir.
enable_safety_checkerdewisol
Mathboolean
Rhagosodedigtrue
Gellir llacio'r sgrinio drwy osod false, ar yr amod bod y galwr wedi'i awdurdodi.
gofynnol Enw canonaidd, derbyniol hefyd

Mae paramedrau ffeil yn derbyn URL cyhoeddus https://, URI data: hyd at 10 MB, neu file_url uwchlwythiad. Ffeiliau

Allbwn

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"
  }
}
Eich ffeiliau, eich dewisMae pob outputs[].url yn gopi ar ein storio: wedi'i gadw am byth (telir fesul GB-mis) neu am 7 diwrnod am ddim, yn ôl gosodiad eich cyfrif neu ?storage=.
Yr un siâp ar bob modeltype, url, content_type, width, height a duration, ar gyfer delweddau, fideo a sain fel ei gilydd. Gwrthrych canlyniad y model ei hun yw output.
Meysydd yr allbwn
model_mesh
object {url, content_type, file_name, file_size}Ffeil sy'n cynnwys y gwrthrych 3D a gynhyrchwyd.
model_meshes
array of object {url, content_type, file_name, file_size}Ffeiliau gwrthrych 3D ychwanegol a gynhyrchir gan Hyper3D ac a ddychwelir yn ychwanegol at model_mesh.
seed
integerHadau a ddefnyddir wrth gynhyrchu.
textures
array of object {url, content_type, file_name, file_size, width, height}Gweadau a gynhyrchwyd ar gyfer y gwrthrych 3D.

Mwy o fodelau: Delwedd i 3D

Ar gyfer asiantau AI: mae'r dudalen hon fel Markdown ar gael yn https://doitong.com/cy/developers/models/hyper3d/rodin/v2.5/fast.md. Pob model a chanllaw: https://doitong.com/developers/llms.txt