Neidio i'r cynnwys

Hyper3D - Rodin V2.5 - Text to 3D

Integreiddio

ID y model hyper3d/rodin/v2.5/text-to-3d
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

Y cais hwn: $0.40 400 o gredydau API · ≈ ₽43.03 Ei redeg ar y dudalen hon

Cael allwedd API
Hyper3D Testun i 3D Allbwn 4KCyflym #text-to-3d

Testun-i-3D gyda Rodin V2.5 ar draws chwe haen, o awgrym hyd at 1024 nod

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.

•gofynnol 88 / 1024

Cyfarwyddiadau testun sy'n arwain cynhyrchu'r model; yn orfodol yn Text-to-3D.

Uwch geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
geometry_file_format rhagosodedig glb

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

material rhagosodedig All

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

Haen manylder rhwyll; mae cynyddu'r haen yn ychwanegu manylder, ond mae Gen-2.5-Minimum yn actifadu modd minimum yn awtomatig ac yn gorfodi 50K Triangle waeth beth fo quality_mesh_option. Mae rhagor o fanylion yn y [ddogfennaeth](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

rhagosodedig Auto

Topoleg ac ansawdd rhwyll, gyda nifer yr wynebau sydd ar gael wedi'i bennu gan yr haen: mae Extreme-Low, Low a Medium yn caniatáu hyd at 1M Triangle; mae High ac Extreme-High yn cefnogi 20K Triangle hyd at 2M Triangle. Mae Auto yn defnyddio'r gosodiadau argymelledig hyn: 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. Ar gyfer dewis â llaw, mae Quad yn ffafrio arwynebau llyfn a Triangle yn ffafrio geometreg fanwl; mae'r Hyper3D API yn derbyn y topoleg fel `mesh_mode` (Quad/Raw) a nifer yr wynebau fel `quality_override`.

Hadau hapddewisol gydag ystod o 0–65535.

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

Opsiynau ychwanegol i'w cymhwyso, os oes angen.

POST /run/hyper3d/rodin/v2.5/text-to-3d?wait=20 dyfynbris → $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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

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 - Text to 3D

Yn cynhyrchu model 3D o `prompt` gofynnol hyd at 1024 nod. Dewiswch `tier` o Gen-2.5-Minimum i Gen-2.5-Extreme-High (High yn ddiofyn), maint rhwyll mewn quadau neu drionglau, a `material` fel PBR neu Shaded. Allforiwch fel glb, usdz, fbx, obj neu stl, a gosodwch `seed` rhwng 0 a 65535.

Paramedrau

EnwMath RhagosodedigCaniateir Disgrifiad
promptgofynnol
Mathstring
≤ 1,024 nod
Cyfarwyddiadau testun sy'n arwain cynhyrchu'r model; yn orfodol yn Text-to-3D.
tierdewisol
Mathenum
RhagosodedigGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Haen manylder rhwyll; mae cynyddu'r haen yn ychwanegu manylder, ond mae Gen-2.5-Minimum yn actifadu modd minimum yn awtomatig ac yn gorfodi 50K Triangle waeth beth fo quality_mesh_option. Mae rhagor o fanylion yn y [ddogfennaeth](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
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
RhagosodedigAll
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
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topoleg ac ansawdd rhwyll, gyda nifer yr wynebau sydd ar gael wedi'i bennu gan yr haen: mae Extreme-Low, Low a Medium yn caniatáu hyd at 1M Triangle; mae High ac Extreme-High yn cefnogi 20K Triangle hyd at 2M Triangle. Mae Auto yn defnyddio'r gosodiadau argymelledig hyn: 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. Ar gyfer dewis â llaw, mae Quad yn ffafrio arwynebau llyfn a Triangle yn ffafrio geometreg fanwl; mae'r Hyper3D API yn derbyn y topoleg fel `mesh_mode` (Quad/Raw) a nifer yr wynebau fel `quality_override`.
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.
addonsdewisol
Mathobject
Opsiynau ychwanegol i'w cymhwyso, os oes angen.
addons.high_packdewisol
Mathboolean
Rhagosodedigfalse
Gwelliant HighPack: mae gan allbwn Quad tua 16 gwaith nifer yr wynebau y gofynnwyd amdanynt drwy'r paramedr ansawdd, ac mae gweadau'n defnyddio cydraniad 4K yn hytrach na'r rhagosodiad 2K.
enable_safety_checkerdewisol
Mathboolean
Rhagosodedigtrue
Gellir llacio'r sgrinio drwy osod false, ar yr amod bod y galwr wedi'i awdurdodi.
gofynnol

Allbwn

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-to-3d",
  "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": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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"
  }
}
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: Testun 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/text-to-3d.md. Pob model a chanllaw: https://doitong.com/developers/llms.txt