Pāriet uz saturu

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

Integrēt

Modeļa 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"

Šis pieprasījums: 0,10 $ 100 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Hyper3D Attēls uz 3D 4K izvadeĀtrs #image-to-3d

Ātrāka Rodin V2.5 attēla pārveidošana par 3D modeli, ierobežota ar trim zemākajiem līmeņiem ātrai prototipēšanai

Hyper3D · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

0 / 1024

Vadiet ģenerēšanu ar tekstu vai Image-to-3D režīmā atstājiet šo lauku tukšu, lai modelis automātiski izveidotu uzvedni no attēliem.

Papildu 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
Nometiet failu vai · līdz 5

Avota attēlu URL; ne vairāk kā 5 attēli, un Image-to-3D režīmā tie ir obligāti modeļa ģenerēšanai.

geometry_file_format noklusējums glb

Ģeometrijas faila formāts, izvēloties glb, usdz, fbx, obj vai stl; noklusējums ir glb.

material noklusējums Shaded

Materiāla izvades izvēle: izvēlieties None ģeometrijai bez tekstūrām vai All, lai saņemtu abus materiāla variantus. Reālistiskam apgaismojumam ar fizikāli pamatotiem materiāliem izvēlieties PBR; ieceptam apgaismojumam bez PBR kartēm izvēlieties Shaded.

texture_mode

Izvēlieties tekstūras kvalitāti tieši vai ļaujiet to izvēlēties API, kas izmanto līmenim piemērotu noklusējumu.

noklusējums Gen-2.5-Extreme-Low

Ģenerēšanas līmenis; Gen-2.5-Minimum piespiež minimum režīmu un 50K Triangle režģi neatkarīgi no `quality_mesh_option`. Līmeņu informācija pieejama [Hyper3D dokumentācijā](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

noklusējums Auto

Izvēlieties kvalitāti kopā ar režģa topoloģiju: Quad dod priekšroku gludām virsmām, bet Triangle — ģeometriskām detaļām. Ātrais galapunkts galvenokārt paredzēts testēšanai un prototipēšanai ar 20K ierobežojumu; augstākas kvalitātes režģiem izmantojiet standarta galapunktu, kur Minimum, Extreme-Low un Low atbalsta līdz 1M Triangle, bet pieejamo skaldņu skaitu nosaka līmenis. Hyper3D API `quality_override` norāda skaldņu skaitu, bet `mesh_mode` — Quad/Raw. Auto izvēlas ieteiktos iestatījumus: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Neobligāta nejaušināšanas sēkla diapazonā no 0–65535.

Ierobežo ģenerētā modeļa izmēru, izmantojot ControlNet.

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

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

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

Izveido 3D modeli no viena līdz pieciem attēliem laukā `image_urls` un neobligātas `prompt`. `tier` ir ierobežots ar Minimum, Extreme-Low (pēc noklusējuma) un Low, bet režģa iespējas nepārsniedz 20K skaldņu. Materiāls pēc noklusējuma ir Shaded. Izvades formāti ir glb, usdz, fbx, obj vai stl.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlsneobligāts images
Tipsurl[] · image
≤ 5 vienumi
Avota attēlu URL; ne vairāk kā 5 attēli, un Image-to-3D režīmā tie ir obligāti modeļa ģenerēšanai.
tierneobligāts
Tipsenum
NoklusējumsGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Ģenerēšanas līmenis; Gen-2.5-Minimum piespiež minimum režīmu un 50K Triangle režģi neatkarīgi no `quality_mesh_option`. Līmeņu informācija pieejama [Hyper3D dokumentācijā](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptneobligāts
Tipsstring
Noklusējums
≤ 1024 rakstzīmes
Vadiet ģenerēšanu ar tekstu vai Image-to-3D režīmā atstājiet šo lauku tukšu, lai modelis automātiski izveidotu uzvedni no attēliem.
use_original_alphaneobligāts
Tipsboolean
Noklusējumsfalse
Kontrolē ievades attēla caurspīdīguma kanālu saglabāšanu 3D satura ģenerēšanas laikā.
seedneobligāts
Tipsinteger | null
0 – 65 535
Neobligāta nejaušināšanas sēkla diapazonā no 0–65535.
geometry_file_formatneobligāts
Tipsenum
Noklusējumsglb
glbusdzfbxobjstl
Ģeometrijas faila formāts, izvēloties glb, usdz, fbx, obj vai stl; noklusējums ir glb.
materialneobligāts
Tipsenum
NoklusējumsShaded
PBRShadedAllNone
Materiāla izvades izvēle: izvēlieties None ģeometrijai bez tekstūrām vai All, lai saņemtu abus materiāla variantus. Reālistiskam apgaismojumam ar fizikāli pamatotiem materiāliem izvēlieties PBR; ieceptam apgaismojumam bez PBR kartēm izvēlieties Shaded.
quality_mesh_optionneobligāts
Tipsenum
NoklusējumsAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Izvēlieties kvalitāti kopā ar režģa topoloģiju: Quad dod priekšroku gludām virsmām, bet Triangle — ģeometriskām detaļām. Ātrais galapunkts galvenokārt paredzēts testēšanai un prototipēšanai ar 20K ierobežojumu; augstākas kvalitātes režģiem izmantojiet standarta galapunktu, kur Minimum, Extreme-Low un Low atbalsta līdz 1M Triangle, bet pieejamo skaldņu skaitu nosaka līmenis. Hyper3D API `quality_override` norāda skaldņu skaitu, bet `mesh_mode` — Quad/Raw. Auto izvēlas ieteiktos iestatījumus: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeneobligāts
Tipsenum
legacyextreme-lowlowmediumhigh
Izvēlieties tekstūras kvalitāti tieši vai ļaujiet to izvēlēties API, kas izmanto līmenim piemērotu noklusējumu.
enable_creative_modeneobligāts
Tipsboolean
Noklusējumsfalse
Radošās ģenerēšanas režīms, kas Hyper3D API atbilst `geometry_instruct_mode` iestatījumam `creative`. Tā iespējošana padara ģenerēšanu noturīgāku, nezaudējot izvades konsekvenci.
hd_textureneobligāts
Tipsboolean
Noklusējumsfalse
Kontrolē papildu tekstūru pēcapstrādi vizuālās precizitātes uzlabošanai.
texture_delightneobligāts
Tipsboolean
Noklusējumsfalse
No ģenerētajām tekstūrām noņem iecepto apgaismojumu un izgaismojumus.
is_microneobligāts
Tipsboolean
Noklusējumsfalse
Pievieno smalkākas ģeometriskās detaļas mikromērogā; darbojas tikai tad, ja `tier="Gen-2.5-Extreme-High"`.
TAPoseneobligāts
Tipsboolean
Noklusējumsfalse
Rakstzīmes pozas iestatījums vienkāršākai takelāžai un animācijai 3D programmatūrā: iespējošana ģenerē rakstzīmes T pozā vai A pozā.
bbox_conditionneobligāts
Tipsobject
Ierobežo ģenerētā modeļa izmēru, izmantojot ControlNet.
bbox_condition.widthneobligāts
Tipsinteger
Noklusējums0
1 – 2048
Norobežojošā lodziņa ierobežojuma platums uz x ass.
bbox_condition.heightneobligāts
Tipsinteger
Noklusējums0
1 – 2048
Norobežojošā lodziņa ierobežojuma augstums uz y ass.
bbox_condition.lengthneobligāts
Tipsinteger
Noklusējums0
1 – 2048
Norobežojošā lodziņa ierobežojuma garums uz z ass.
preview_renderneobligāts
Tipsboolean
Noklusējumsfalse
Priekšskatījuma renderēšanas pārslēgs, kas piegādātajiem modeļa failiem pievieno attēlu ar ģenerēto 3D modeli.
enable_safety_checkerneobligāts
Tipsboolean
Noklusējumstrue
Pārbaudi var atslābināt, iestatot false, ja izsaucējam ir atļauja.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
model_mesh
object {url, content_type, file_name, file_size}Fails ar ģenerēto 3D objektu.
model_meshes
array of object {url, content_type, file_name, file_size}Papildu 3D objektu faili, ko ģenerē Hyper3D un kas tiek atgriezti papildus model_mesh.
seed
integerĢenerēšanas laikā izmantotā sēkla.
textures
array of object {url, content_type, file_name, file_size, width, height}3D objektam izveidotās tekstūras.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/hyper3d/rodin/v2.5/fast.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt