Léim chuig an ábhar

Hyper3d

Comhtháthú

Aitheantas na samhla hyper3d/rodin/v2
# 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?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"

An t-iarratas seo: $0.40 400 gcreidmheas API Rith ar an leathanach seo

Faigh eochair API
Hyper3D Íomhá go 3D Aschur 4KTapa #image-to-3d#text-to-3d

Rodin v2 téacs nó íomhá go 3D le suas le 5 íomhá ionchuir, réamhshocruithe mogalra ceathairshleasach nó triantánach agus rindreáil réamhamhairc

Hyper3D · 3D

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

0 / 1024

Treoraigh an ghiniúint le leid téacs, nó fág bán é i mód Image-to-3D ionas go ndíorthóidh AI an leid ó d’íomhánna.

Ardleibhéal input_image_urls · geometry_file_format · material · quality_mesh_option · addons · seed · use_original_alpha · TAPose · preview_render · bbox_condition
Scaoil comhad, nó

URLanna íomhánna foinse, teoranta do 5 íomhá agus riachtanach i mód Image-to-3D, chun an tsamhail a ghiniúint.

geometry_file_format réamhshocrú glb

Formáid chomhaid gheoiméadrachta, roghnaithe as glb, usdz, fbx, obj, stl; is é glb an réamhshocrú.

material réamhshocrú All

Rogha ábhair, agus All ag áireamh an dá rogha: úsáideann PBR cur chuige fisiciúil-bhunaithe le haghaidh soilsiú réalaíoch, agus úsáideann Shaded ábhair shimplí agus soilsiú bácáilte.

quality_mesh_option réamhshocrú 500K Triangle

Rogha chomhcheangailte mogaill agus cáilíochta, mapáilte san Hyper3D API chuig `quality_override` ag úsáid cuid uimhriúil na rogha agus chuig `mesh_mode` ag úsáid 'Raw' má tá 'Triangle' sa rogha, nó 'Quad' murach sin. Is fearr le Quad dromchlaí mín; is fearr le Triangle geoiméadracht mhionsonraithe.

Soláthraíonn HighPack samhlacha ardpholagáin agus uasghrádaíonn sé taifeach na huigeachta ón réamhshocrú 1K go 4K.

Síol randamaithe roghnach, idir 0–65535.

Méid an bhosca teorannaithe mar eagar san ord [width, height, length].

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

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Hyper3d

Cruthaíonn sé samhlacha 3D ó leid (suas le 1024 carachtar) agus suas le 5 íomhá in `input_image_urls`. Tairgeann `quality_mesh_option` mogalraí ceathairshleasacha ó 4K go 50K agus mogalraí triantánacha ó 2K go 500K. Tacaíonn sé le `material` PBR, Shaded nó All, `TAPose`, `use_original_alpha` agus `preview_render`.

Paraiméadair

AinmCineál RéamhshocrúCeadaithe Cur síos
promptroghnach
Cineálstring
Réamhshocrú
≤ 1,024 gcarachtar
Treoraigh an ghiniúint le leid téacs, nó fág bán é i mód Image-to-3D ionas go ndíorthóidh AI an leid ó d’íomhánna.
input_image_urlsroghnach
Cineálurl[] · image
URLanna íomhánna foinse, teoranta do 5 íomhá agus riachtanach i mód Image-to-3D, chun an tsamhail a ghiniúint.
use_original_alpharoghnach
Cineálboolean
Réamhshocrúfalse
Rialaíonn sé coinneáil chainéil trédhearcachta na híomhá ionchuir agus ábhar 3D á ghiniúint.
seedroghnach
Cineálinteger | null
0 – 65,535
Síol randamaithe roghnach, idir 0–65535.
geometry_file_formatroghnach
Cineálenum
Réamhshocrúglb
glbusdzfbxobjstl
Formáid chomhaid gheoiméadrachta, roghnaithe as glb, usdz, fbx, obj, stl; is é glb an réamhshocrú.
materialroghnach
Cineálenum
RéamhshocrúAll
PBRShadedAll
Rogha ábhair, agus All ag áireamh an dá rogha: úsáideann PBR cur chuige fisiciúil-bhunaithe le haghaidh soilsiú réalaíoch, agus úsáideann Shaded ábhair shimplí agus soilsiú bácáilte.
quality_mesh_optionroghnach
Cineálenum
Réamhshocrú500K Triangle
4K Quad8K Quad18K Quad50K Quad2K Triangle20K Triangle150K Triangle500K Triangle
Rogha chomhcheangailte mogaill agus cáilíochta, mapáilte san Hyper3D API chuig `quality_override` ag úsáid cuid uimhriúil na rogha agus chuig `mesh_mode` ag úsáid 'Raw' má tá 'Triangle' sa rogha, nó 'Quad' murach sin. Is fearr le Quad dromchlaí mín; is fearr le Triangle geoiméadracht mhionsonraithe.
TAPoseroghnach
Cineálboolean
Réamhshocrúfalse
Socrú staidiúir charachtair le haghaidh rigging agus beochana níos éasca i mbogearraí 3D: gineann é a chumasú carachtair i staidiúir T nó A.
bbox_conditionroghnach
Cineálinteger[]
Méid an bhosca teorannaithe mar eagar san ord [width, height, length].
addonsroghnach
Cineálstring | null
Soláthraíonn HighPack samhlacha ardpholagáin agus uasghrádaíonn sé taifeach na huigeachta ón réamhshocrú 1K go 4K.
preview_renderroghnach
Cineálboolean
Réamhshocrúfalse
Scorán réamhamhairc-rindreála a chuireann íomhá den tsamhail 3D ginte leis na comhaid samhla seachadta.
riachtanach

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2",
  "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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
model_mesh
object {url, content_type, file_name, file_size}Comhad ina bhfuil an réad 3D ginte.
model_meshes
array of object {url, content_type, file_name, file_size}Comhaid réada 3D bhreise a ghineann Hyper3D agus a sheoltar ar ais sa bhreis ar model_mesh.
seed
integerSíol a chuirtear i bhfeidhm le linn giniúna.
textures
array of object {url, content_type, file_name, file_size, width, height}Uigeachtaí a táirgeadh don réad 3D.

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/hyper3d/rodin/v2.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt