Hoppa till innehåll

Hyper3D - Rodin V2.5 - Image to 3D

Integrera

Modell-id hyper3d/rodin/v2.5
# 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?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Den här begäran: 0,40 $ 400 API-krediter · ≈ 41,88 ₽ Kör den på den här sidan

Hämta API-nyckel
Hyper3D Bild till 3D 4K-utdataSnabb #image-to-3d

Bild-till-3D med Rodin V2.5 med upp till 5 referensbilder och val mellan kvalitetsnivåer

Hyper3D · 3D

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

0 / 1024

Vägled genereringen med text, eller låt modellen automatiskt härleda en prompt från bilderna genom att lämna detta tomt i Image-to-3D-läge.

Avancerat 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 · addons
image_urls
Släpp en fil eller · upp till 5

URL:er till källbilder, begränsade till 5 bilder och obligatoriska i Image-to-3D-läge, för generering av modellen.

geometry_file_format standard glb

Filformat för geometri, valt från glb, usdz, fbx, obj, stl; standard är glb.

material standard All

Val av materialutdata: välj None för geometri utan texturer eller All för att få båda materialvarianterna. För realistisk belysning med fysiskt baserade material väljer du PBR; för bakad belysning utan PBR-mappar väljer du Shaded.

texture_mode

Välj texturkvalitet uttryckligen eller låt API:t välja, vilket använder ett standardvärde som passar nivån.

standard Gen-2.5-High

Nivå för meshdetaljer; en högre nivå lägger till detaljer, men Gen-2.5-Minimum aktiverar automatiskt minimum-läget och tvingar fram 50K Triangle oavsett quality_mesh_option. Mer information finns i [dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standard Auto

Mesh-topologi och kvalitet, där tillgängligt antal ytor bestäms av nivån: Extreme-Low, Low och Medium tillåter upp till 1M Triangle; High och Extreme-High stöder från 20K Triangle till 2M Triangle. Auto tillämpar dessa rekommenderade inställningar: 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. Vid manuellt val prioriterar Quad släta ytor och Triangle detaljerad geometri; Hyper3D API tar emot topologin som `mesh_mode` (Quad/Raw) och antalet ytor som `quality_override`.

Valfri slumpmässig seed med intervallet 0–65535.

Begränsa hur stor den genererade modellen får vara med hjälp av en ControlNet.

Valfritt tillägg som anges som en lista eller, för ett enda tillägg, som ett enskilt värde.

POST /run/hyper3d/rodin/v2.5?wait=20 pris → 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?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

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

Skapar en 3D-modell från en till fem bilder i `image_urls`, med valfri `prompt` på upp till 1024 tecken. Sex nivåer sträcker sig från Gen-2.5-Minimum till Gen-2.5-Extreme-High, med High som standard. Alternativen omfattar geometriformat (glb, usdz, fbx, obj, stl), `material`, fyrhörnings- eller triangelstorlekar, `TAPose` för riggvänliga figurer och `hd_texture`.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
promptvalfritt
Typstring
Standard
≤ 1 024 tecken
Vägled genereringen med text, eller låt modellen automatiskt härleda en prompt från bilderna genom att lämna detta tomt i Image-to-3D-läge.
image_urlsvalfritt images
Typurl[] · image
≤ 5 objekt
URL:er till källbilder, begränsade till 5 bilder och obligatoriska i Image-to-3D-läge, för generering av modellen.
tiervalfritt
Typenum
StandardGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Nivå för meshdetaljer; en högre nivå lägger till detaljer, men Gen-2.5-Minimum aktiverar automatiskt minimum-läget och tvingar fram 50K Triangle oavsett quality_mesh_option. Mer information finns i [dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphavalfritt
Typboolean
Standardfalse
Styr om transparenskanaler i indatabilder bevaras när 3D-innehåll genereras.
seedvalfritt
Typinteger | null
0 – 65 535
Valfri slumpmässig seed med intervallet 0–65535.
geometry_file_formatvalfritt
Typenum
Standardglb
glbusdzfbxobjstl
Filformat för geometri, valt från glb, usdz, fbx, obj, stl; standard är glb.
materialvalfritt
Typenum
StandardAll
PBRShadedAllNone
Val av materialutdata: välj None för geometri utan texturer eller All för att få båda materialvarianterna. För realistisk belysning med fysiskt baserade material väljer du PBR; för bakad belysning utan PBR-mappar väljer du Shaded.
quality_mesh_optionvalfritt
Typenum
StandardAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh-topologi och kvalitet, där tillgängligt antal ytor bestäms av nivån: Extreme-Low, Low och Medium tillåter upp till 1M Triangle; High och Extreme-High stöder från 20K Triangle till 2M Triangle. Auto tillämpar dessa rekommenderade inställningar: 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. Vid manuellt val prioriterar Quad släta ytor och Triangle detaljerad geometri; Hyper3D API tar emot topologin som `mesh_mode` (Quad/Raw) och antalet ytor som `quality_override`.
texture_modevalfritt
Typenum
legacyextreme-lowlowmediumhigh
Välj texturkvalitet uttryckligen eller låt API:t välja, vilket använder ett standardvärde som passar nivån.
enable_creative_modevalfritt
Typboolean
Standardfalse
Kreativt genereringsläge, motsvarande `geometry_instruct_mode` inställt på `creative` i Hyper3D API. När det aktiveras blir genereringen mer robust utan att utdata blir mindre konsekvent.
hd_texturevalfritt
Typboolean
Standardfalse
Styr avancerad efterbehandling av texturer för att förbättra visuell återgivning.
texture_delightvalfritt
Typboolean
Standardfalse
Tar bort inbakad belysning och högdagrar från genererade texturer.
is_microvalfritt
Typboolean
Standardfalse
Lägger till finare geometriska detaljer på mikronivå; gäller endast när `tier="Gen-2.5-Extreme-High"`.
TAPosevalfritt
Typboolean
Standardfalse
Inställning för karaktärspose som underlättar riggning och animering i 3D-programvara: när den aktiveras genereras karaktärer i T-pose eller A-pose.
bbox_conditionvalfritt
Typobject
Begränsa hur stor den genererade modellen får vara med hjälp av en ControlNet.
bbox_condition.widthvalfritt
Typinteger
Standard0
1 – 2 048
Breddbegränsning för begränsningsboxen längs x-axeln.
bbox_condition.heightvalfritt
Typinteger
Standard0
1 – 2 048
Höjdbegränsning för begränsningsboxen längs y-axeln.
bbox_condition.lengthvalfritt
Typinteger
Standard0
1 – 2 048
Längdbegränsning för begränsningsboxen längs z-axeln.
addonsvalfritt
Typobject
Valfritt tillägg som anges som en lista eller, för ett enda tillägg, som ett enskilt värde.
addons.high_packvalfritt
Typboolean
Standardfalse
HighPack-förbättring: Quad-utdata har ungefär 16 gånger så många ytor som begärts genom kvalitetsparametern, och texturerna använder 4K-upplösning i stället för standardvärdet 2K.
preview_rendervalfritt
Typboolean
Standardfalse
Växlare för förhandsrendering som lägger till en bild av den genererade 3D-modellen bland de levererade modellfilerna.
enable_safety_checkervalfritt
Typboolean
Standardtrue
Granskningen kan lättas genom att ange false, om anroparen är behörig.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5",
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
model_mesh
object {url, content_type, file_name, file_size}Fil som innehåller det genererade 3D-objektet.
model_meshes
array of object {url, content_type, file_name, file_size}Extra 3D-objektfiler som genereras av Hyper3D och returneras utöver model_mesh.
seed
integerSeed som används under genereringen.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturer som skapats för 3D-objektet.

Fler modeller: Bild till 3D

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/hyper3d/rodin/v2.5.md. Alla modeller och guider: https://doitong.com/developers/llms.txt