Gå til innhold

Hyper3D - Rodin V2.5 - Image to 3D

Integrer

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"

Denne forespørselen: 0,40 $ 400 API-kreditter · ≈ 42,19 ₽ Kjør den på denne siden

Hent API-nøkkel
Hyper3D Bilde til 3D 4K-utdataRask #image-to-3d

Bilde-til-3D med Rodin V2.5 ved hjelp av opptil 5 referansebilder og valgfri kvalitetsnivå

Hyper3D · 3D

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

0 / 1024

Styr genereringen med tekst, eller la modellen utlede en prompt automatisk fra bildene ved å la dette stå tomt i Image-to-3D-modus.

Avansert 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
Slipp en fil, eller · opptil 5

URL-er til kildebilder, begrenset til 5 bilder og obligatoriske i Image-to-3D-modus, for generering av modellen.

geometry_file_format standard glb

Filformat for geometri, valgt fra glb, usdz, fbx, obj, stl; standard er glb.

material standard All

Valg av materialutdata: velg None for geometri uten teksturer, eller All for å motta begge materialvariantene. For realistisk belysning med fysisk baserte materialer velger du PBR; for bakt belysning uten PBR-kart velger du Shaded.

texture_mode

Velg teksturkvaliteten uttrykkelig, eller la API-et velge ved å bruke en standard som passer nivået.

standard Gen-2.5-High

Nivå for mesh-detaljer; et høyere nivå gir mer detaljer, men Gen-2.5-Minimum aktiverer minimumsmodus automatisk og tvinger 50K Triangle uavhengig av quality_mesh_option. Flere detaljer finnes i [dokumentasjonen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standard Auto

Mesh-topologi og kvalitet, med tilgjengelig antall flater bestemt av nivået: Extreme-Low, Low og Medium tillater opptil 1M Triangle; High og Extreme-High støtter fra 20K Triangle til 2M Triangle. Auto bruker disse anbefalte innstillingene: 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. Ved manuelt valg favoriserer Quad jevne overflater, mens Triangle favoriserer detaljert geometri; Hyper3D API mottar topologien som `mesh_mode` (Quad/Raw) og antall flater som `quality_override`.

Valgfri randomiseringsseed fra 0–65535.

Begrens hvor stor den genererte modellen kan være ved hjelp av en ControlNet.

Valgfritt tillegg, oppgitt som en liste eller, for ett enkelt tillegg, som én verdi.

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"

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

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

Bygger en 3D-modell fra ett til fem bilder i `image_urls`, med valgfri `prompt` på opptil 1024 tegn. Seks nivåer går fra Gen-2.5-Minimum til Gen-2.5-Extreme-High, med High som standard. Alternativer omfatter geometriformat (glb, usdz, fbx, obj, stl), `material`, størrelser for firkant- eller trekantnett, `TAPose` for riggvennlige figurer og `hd_texture`.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
promptvalgfritt
Typestring
Standard
≤ 1 024 tegn
Styr genereringen med tekst, eller la modellen utlede en prompt automatisk fra bildene ved å la dette stå tomt i Image-to-3D-modus.
image_urlsvalgfritt images
Typeurl[] · image
≤ 5 elementer
URL-er til kildebilder, begrenset til 5 bilder og obligatoriske i Image-to-3D-modus, for generering av modellen.
tiervalgfritt
Typeenum
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å for mesh-detaljer; et høyere nivå gir mer detaljer, men Gen-2.5-Minimum aktiverer minimumsmodus automatisk og tvinger 50K Triangle uavhengig av quality_mesh_option. Flere detaljer finnes i [dokumentasjonen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphavalgfritt
Typeboolean
Standardfalse
Styrer bevaring av transparenskanaler i inndatabildet ved generering av 3D-innhold.
seedvalgfritt
Typeinteger | null
0 – 65 535
Valgfri randomiseringsseed fra 0–65535.
geometry_file_formatvalgfritt
Typeenum
Standardglb
glbusdzfbxobjstl
Filformat for geometri, valgt fra glb, usdz, fbx, obj, stl; standard er glb.
materialvalgfritt
Typeenum
StandardAll
PBRShadedAllNone
Valg av materialutdata: velg None for geometri uten teksturer, eller All for å motta begge materialvariantene. For realistisk belysning med fysisk baserte materialer velger du PBR; for bakt belysning uten PBR-kart velger du Shaded.
quality_mesh_optionvalgfritt
Typeenum
StandardAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh-topologi og kvalitet, med tilgjengelig antall flater bestemt av nivået: Extreme-Low, Low og Medium tillater opptil 1M Triangle; High og Extreme-High støtter fra 20K Triangle til 2M Triangle. Auto bruker disse anbefalte innstillingene: 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. Ved manuelt valg favoriserer Quad jevne overflater, mens Triangle favoriserer detaljert geometri; Hyper3D API mottar topologien som `mesh_mode` (Quad/Raw) og antall flater som `quality_override`.
texture_modevalgfritt
Typeenum
legacyextreme-lowlowmediumhigh
Velg teksturkvaliteten uttrykkelig, eller la API-et velge ved å bruke en standard som passer nivået.
enable_creative_modevalgfritt
Typeboolean
Standardfalse
Kreativ genereringsmodus, tilsvarende `geometry_instruct_mode` satt til `creative` i Hyper3D API. Aktivering gjør genereringen mer robust uten å svekke konsistensen i utdataene.
hd_texturevalgfritt
Typeboolean
Standardfalse
Styrer avansert etterbehandling av teksturer for å forbedre visuell gjengivelse.
texture_delightvalgfritt
Typeboolean
Standardfalse
Fjerner innbakt belysning og høylys fra genererte teksturer.
is_microvalgfritt
Typeboolean
Standardfalse
Legger til finere geometriske detaljer på mikronivå; gjelder bare når `tier="Gen-2.5-Extreme-High"`.
TAPosevalgfritt
Typeboolean
Standardfalse
Innstilling for karakterpositur som gjør rigging og animasjon i 3D-programvare enklere: aktivering genererer karakterer i enten T-pose eller A-pose.
bbox_conditionvalgfritt
Typeobject
Begrens hvor stor den genererte modellen kan være ved hjelp av en ControlNet.
bbox_condition.widthvalgfritt
Typeinteger
Standard0
1 – 2 048
Betingelse for avgrensningsboksens bredde langs x-aksen.
bbox_condition.heightvalgfritt
Typeinteger
Standard0
1 – 2 048
Betingelse for avgrensningsboksens høyde langs y-aksen.
bbox_condition.lengthvalgfritt
Typeinteger
Standard0
1 – 2 048
Betingelse for avgrensningsboksens lengde langs z-aksen.
addonsvalgfritt
Typeobject
Valgfritt tillegg, oppgitt som en liste eller, for ett enkelt tillegg, som én verdi.
addons.high_packvalgfritt
Typeboolean
Standardfalse
HighPack-forbedring: Quad-utdata har omtrent 16 ganger så mange flater som angitt gjennom kvalitetsparameteren, og teksturer bruker 4K-oppløsning i stedet for standarden 2K.
preview_rendervalgfritt
Typeboolean
Standardfalse
Bryter for forhåndsvisningsgjengivelse som legger til et bilde av den genererte 3D-modellen i de leverte modellfilene.
enable_safety_checkervalgfritt
Typeboolean
Standardtrue
Filtreringen kan lempes ved å angi false, forutsatt at den som gjør forespørselen, er autorisert.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
model_mesh
object {url, content_type, file_name, file_size}Fil som inneholder det genererte 3D-objektet.
model_meshes
array of object {url, content_type, file_name, file_size}Ekstra 3D-objektfiler generert av Hyper3D og returnert i tillegg til model_mesh.
seed
integerSeed brukt under generering.
textures
array of object {url, content_type, file_name, file_size, width, height}Teksturer produsert for 3D-objektet.

Flere modeller: Bilde til 3D

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/hyper3d/rodin/v2.5.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt