Siirry sisältöön

Hyper3d

Integroi

Mallin tunniste 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"

Tämä pyyntö: 0,40 $ 400 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Hyper3D Kuvasta 3D:ksi 4K-tulosteNopea #image-to-3d#text-to-3d

Rodin v2 tekstistä tai kuvasta 3D-malliksi enintään 5 syötekuvalla, neliö- tai kolmiomallin esiasetuksilla ja esikatselurenderöinnillä

Hyper3D · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

0 / 1024

Ohjaa generointia tekstikehotteella tai jätä tyhjäksi Image-to-3D-tilassa, jolloin tekoäly muodostaa kehotteen kuvistasi.

Lisäasetukset input_image_urls · geometry_file_format · material · quality_mesh_option · addons · seed · use_original_alpha · TAPose · preview_render · bbox_condition
Pudota tiedosto tai

Mallin generointiin käytettävien lähdekuvien URL-osoitteet. Enintään 5 kuvaa, pakollinen Image-to-3D-tilassa.

geometry_file_format oletus glb

Geometrian tiedostomuoto: glb, usdz, fbx, obj tai stl; oletus on glb.

material oletus All

Materiaalivalinta. All sisältää molemmat vaihtoehdot: PBR käyttää fysikaalisesti perustuvaa menetelmää realistiseen valaistukseen, kun taas Shaded käyttää yksinkertaisia materiaaleja ja tekstuureihin leivottua valaistusta.

quality_mesh_option oletus 500K Triangle

Verkon ja laadun yhdistelmävalinta, joka välitetään Hyper3D API:ssa `quality_override`-parametriin valinnan numero-osan perusteella ja `mesh_mode`-parametriin arvona 'Raw', jos valinta sisältää 'Triangle', tai muuten arvona 'Quad'. Quad suosii sileitä pintoja, Triangle yksityiskohtaista geometriaa.

HighPack tarjoaa runsaspolygonisia malleja ja nostaa tekstuurien resoluution oletusarvosta 1K arvoon 4K.

Valinnainen satunnaissiemen välillä 0–65535.

Rajauslaatikon koko taulukkona järjestyksessä [width, height, length].

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Hyper3d

Luo 3D-malleja enintään 1024 merkin kehotteesta ja enintään 5 `input_image_urls`-kuvasta. `quality_mesh_option` tarjoaa nelikulmioverkot 4K–50K ja kolmioverkot 2K–500K. Tukee materiaaleja `material`: PBR, Shaded tai All, sekä asetuksia `TAPose`, `use_original_alpha` ja `preview_render`.

Parametrit

NimiTyyppi OletusSallitut Kuvaus
promptvalinnainen
Tyyppistring
Oletus
≤ 1 024 merkkiä
Ohjaa generointia tekstikehotteella tai jätä tyhjäksi Image-to-3D-tilassa, jolloin tekoäly muodostaa kehotteen kuvistasi.
input_image_urlsvalinnainen
Tyyppiurl[] · image
Mallin generointiin käytettävien lähdekuvien URL-osoitteet. Enintään 5 kuvaa, pakollinen Image-to-3D-tilassa.
use_original_alphavalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, säilytetäänkö syötekuvien läpinäkyvyyskanavat 3D-sisällön generoinnissa.
seedvalinnainen
Tyyppiinteger | null
0 – 65 535
Valinnainen satunnaissiemen välillä 0–65535.
geometry_file_formatvalinnainen
Tyyppienum
Oletusglb
glbusdzfbxobjstl
Geometrian tiedostomuoto: glb, usdz, fbx, obj tai stl; oletus on glb.
materialvalinnainen
Tyyppienum
OletusAll
PBRShadedAll
Materiaalivalinta. All sisältää molemmat vaihtoehdot: PBR käyttää fysikaalisesti perustuvaa menetelmää realistiseen valaistukseen, kun taas Shaded käyttää yksinkertaisia materiaaleja ja tekstuureihin leivottua valaistusta.
quality_mesh_optionvalinnainen
Tyyppienum
Oletus500K Triangle
4K Quad8K Quad18K Quad50K Quad2K Triangle20K Triangle150K Triangle500K Triangle
Verkon ja laadun yhdistelmävalinta, joka välitetään Hyper3D API:ssa `quality_override`-parametriin valinnan numero-osan perusteella ja `mesh_mode`-parametriin arvona 'Raw', jos valinta sisältää 'Triangle', tai muuten arvona 'Quad'. Quad suosii sileitä pintoja, Triangle yksityiskohtaista geometriaa.
TAPosevalinnainen
Tyyppiboolean
Oletusfalse
Hahmon asentoasetus, joka helpottaa luurangon luontia ja animointia 3D-ohjelmistossa: käytössä ollessaan generoi hahmot joko T- tai A-asentoon.
bbox_conditionvalinnainen
Tyyppiinteger[]
Rajauslaatikon koko taulukkona järjestyksessä [width, height, length].
addonsvalinnainen
Tyyppistring | null
HighPack tarjoaa runsaspolygonisia malleja ja nostaa tekstuurien resoluution oletusarvosta 1K arvoon 4K.
preview_rendervalinnainen
Tyyppiboolean
Oletusfalse
Esikatselurenderöinnin valitsin, joka lisää generoitua 3D-mallia esittävän kuvan toimitettaviin mallitiedostoihin.
pakollinen

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
model_mesh
object {url, content_type, file_name, file_size}Generoidun 3D-objektin sisältävä tiedosto.
model_meshes
array of object {url, content_type, file_name, file_size}Hyper3D:n generoimat ylimääräiset 3D-objektitiedostot, jotka palautetaan model_mesh-kentän lisäksi.
seed
integerGeneroinnin aikana käytettävä siemen.
textures
array of object {url, content_type, file_name, file_size, width, height}3D-objektille tuotetut tekstuurit.

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/hyper3d/rodin/v2.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt