Gå til indhold

Hyper3D - Rodin V2.5 - Image to 3D

Integrer

Model-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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Denne anmodning: 0,40 $ 400 API-kreditter Kør den på denne side

Hent API-nøgle
Hyper3D Billede til 3D 4K-outputHurtig #image-to-3d

Billed-til-3D med Rodin V2.5 ved hjælp af op til 5 referencebilleder og valg mellem kvalitetsniveauer

Hyper3D · 3D

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

0 / 1024

Vejled genereringen med tekst, eller lad modellen automatisk udlede en prompt fra billederne ved at lade feltet være tomt i Image-to-3D-tilstand.

Avanceret 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
Slip en fil, eller · op til 5

Kildebilleders URL'er, begrænset til 5 billeder og obligatoriske i Image-to-3D-tilstand, til generering af modellen.

geometry_file_format standard glb

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

material standard All

Valg af material-output: vælg None for geometri uden teksturer eller All for at modtage begge materialevalianter. Vælg PBR for realistisk belysning med fysisk baserede materialer; vælg Shaded for indbagt belysning uden PBR-kort.

texture_mode

Vælg teksturkvaliteten eksplicit, eller lad API'et vælge den med en standard, der passer til niveauet.

standard Gen-2.5-High

Niveau for mesh-detaljer; et højere niveau tilføjer detaljer, men Gen-2.5-Minimum aktiverer automatisk minimumstilstand og tvinger 50K Triangle uanset quality_mesh_option. Flere oplysninger findes i [dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standard Auto

Meshtopologi og kvalitet, hvor de tilgængelige antal flader bestemmes af niveauet: Extreme-Low, Low og Medium tillader op til 1M Triangle; High og Extreme-High understøtter fra 20K Triangle til 2M Triangle. Auto anvender disse anbefalede indstillinger: 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 prioriterer Quad glatte overflader, og Triangle prioriterer detaljeret geometri; Hyper3D API modtager topologien som `mesh_mode` (Quad/Raw) og antallet af flader som `quality_override`.

Valgfri tilfældig seed med intervallet 0–65535.

Begræns, hvor stor den genererede model kan være, ved hjælp af en ControlNet.

Valgfrit tilføjelsesvalg, angivet som en liste eller som en enkelt værdi, hvis der kun er én tilføjelse.

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

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

Opretter en 3D-model fra et til fem billeder i `image_urls` med valgfri `prompt` på op til 1024 tegn. Seks niveauer går fra Gen-2.5-Minimum til Gen-2.5-Extreme-High med High som standard. Mulighederne omfatter geometriformat (glb, usdz, fbx, obj, stl), `material`, quad- eller triangle-meshstørrelser, `TAPose` til rig-venlige figurer og `hd_texture`.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
promptvalgfri
Typestring
Standard
≤ 1.024 tegn
Vejled genereringen med tekst, eller lad modellen automatisk udlede en prompt fra billederne ved at lade feltet være tomt i Image-to-3D-tilstand.
image_urlsvalgfri images
Typeurl[] · image
≤ 5 elementer
Kildebilleders URL'er, begrænset til 5 billeder og obligatoriske i Image-to-3D-tilstand, til generering af modellen.
tiervalgfri
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
Niveau for mesh-detaljer; et højere niveau tilføjer detaljer, men Gen-2.5-Minimum aktiverer automatisk minimumstilstand og tvinger 50K Triangle uanset quality_mesh_option. Flere oplysninger findes i [dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphavalgfri
Typeboolean
Standardfalse
Styrer, om inputbilleders transparenskanaler bevares ved generering af 3D-indhold.
seedvalgfri
Typeinteger | null
0 – 65.535
Valgfri tilfældig seed med intervallet 0–65535.
geometry_file_formatvalgfri
Typeenum
Standardglb
glbusdzfbxobjstl
Filformat for geometri, valgt blandt glb, usdz, fbx, obj, stl; standard er glb.
materialvalgfri
Typeenum
StandardAll
PBRShadedAllNone
Valg af material-output: vælg None for geometri uden teksturer eller All for at modtage begge materialevalianter. Vælg PBR for realistisk belysning med fysisk baserede materialer; vælg Shaded for indbagt belysning uden PBR-kort.
quality_mesh_optionvalgfri
Typeenum
StandardAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Meshtopologi og kvalitet, hvor de tilgængelige antal flader bestemmes af niveauet: Extreme-Low, Low og Medium tillader op til 1M Triangle; High og Extreme-High understøtter fra 20K Triangle til 2M Triangle. Auto anvender disse anbefalede indstillinger: 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 prioriterer Quad glatte overflader, og Triangle prioriterer detaljeret geometri; Hyper3D API modtager topologien som `mesh_mode` (Quad/Raw) og antallet af flader som `quality_override`.
texture_modevalgfri
Typeenum
legacyextreme-lowlowmediumhigh
Vælg teksturkvaliteten eksplicit, eller lad API'et vælge den med en standard, der passer til niveauet.
enable_creative_modevalgfri
Typeboolean
Standardfalse
Kreativ genereringstilstand, svarende til `geometry_instruct_mode` sat til `creative` i Hyper3D API. Aktivering gør genereringen mere robust uden at gå på kompromis med outputkonsistensen.
hd_texturevalgfri
Typeboolean
Standardfalse
Styrer avanceret efterbehandling af teksturer for at forbedre den visuelle overensstemmelse.
texture_delightvalgfri
Typeboolean
Standardfalse
Fjerner indbagt belysning og højlys fra genererede teksturer.
is_microvalgfri
Typeboolean
Standardfalse
Tilføjer finere geometriske detaljer på mikroniveau; træder kun i kraft, når `tier="Gen-2.5-Extreme-High"`.
TAPosevalgfri
Typeboolean
Standardfalse
Indstilling for karakterpose, der gør rigging og animation i 3D-software lettere: aktivering genererer karakterer i enten T-pose eller A-pose.
bbox_conditionvalgfri
Typeobject
Begræns, hvor stor den genererede model kan være, ved hjælp af en ControlNet.
bbox_condition.widthvalgfri
Typeinteger
Standard0
1 – 2.048
Begrænsning af bounding boxens bredde langs x-aksen.
bbox_condition.heightvalgfri
Typeinteger
Standard0
1 – 2.048
Begrænsning af bounding boxens højde langs y-aksen.
bbox_condition.lengthvalgfri
Typeinteger
Standard0
1 – 2.048
Begrænsning af bounding boxens længde langs z-aksen.
addonsvalgfri
Typeobject
Valgfrit tilføjelsesvalg, angivet som en liste eller som en enkelt værdi, hvis der kun er én tilføjelse.
addons.high_packvalgfri
Typeboolean
Standardfalse
HighPack-forbedring: Quad-output har cirka 16 gange så mange flader som angivet via kvalitetsparameteren, og teksturer bruger 4K-opløsning i stedet for standarden 2K.
preview_rendervalgfri
Typeboolean
Standardfalse
Skift til forhåndsvisningsrendering, som tilføjer et billede af den genererede 3D-model til de leverede modelfiler.
enable_safety_checkervalgfri
Typeboolean
Standardtrue
Screening kan lempes ved at angive false, hvis den kaldende part er autoriseret.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
model_mesh
object {url, content_type, file_name, file_size}Fil, der indeholder det genererede 3D-objekt.
model_meshes
array of object {url, content_type, file_name, file_size}Ekstra 3D-objektfiler genereret af Hyper3D og returneret ud over model_mesh.
seed
integerSeed anvendt under generering.
textures
array of object {url, content_type, file_name, file_size, width, height}Teksturer produceret til 3D-objektet.

Flere modeller: Billede til 3D

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/hyper3d/rodin/v2.5.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt