Gå til indhold

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

Integrer

Model-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"

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

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

Hurtigere Rodin V2.5 billed-til-3D begrænset til de tre laveste niveauer til hurtig prototyping

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
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 Shaded

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-Extreme-Low

Genereringsniveau; Gen-2.5-Minimum tvinger minimumstilstand og et 50K Triangle-mesh uanset `quality_mesh_option`. Niveaudetaljer findes i [Hyper3D-dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standard Auto

Vælg kvalitet sammen med meshtopologi: Quad prioriterer glatte overflader, mens Triangle prioriterer geometriske detaljer. Det hurtige endpoint er primært beregnet til test og prototyper med en grænse på 20K; brug standard-endpointet til mesh med højere kvalitet, hvor Minimum, Extreme-Low og Low understøtter op til 1M Triangle, og de tilgængelige antal flader afhænger af niveauet. I Hyper3D API angiver `quality_override` antallet af flader, mens `mesh_mode` angiver Quad/Raw. Auto vælger de anbefalede indstillinger: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Valgfri tilfældig seed med intervallet 0–65535.

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

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

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 - Fast

Opretter en 3D-model fra et til fem billeder i `image_urls` med valgfri `prompt`. `tier` er begrænset til Minimum, Extreme-Low (standard) og Low, og meshindstillingerne går højst til 20K flader. Materialet er som standard Shaded. Outputformaterne er glb, usdz, fbx, obj eller stl.

Parametre

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

NavnType StandardTilladt Beskrivelse
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-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Genereringsniveau; Gen-2.5-Minimum tvinger minimumstilstand og et 50K Triangle-mesh uanset `quality_mesh_option`. Niveaudetaljer findes i [Hyper3D-dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
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.
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
StandardShaded
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
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Vælg kvalitet sammen med meshtopologi: Quad prioriterer glatte overflader, mens Triangle prioriterer geometriske detaljer. Det hurtige endpoint er primært beregnet til test og prototyper med en grænse på 20K; brug standard-endpointet til mesh med højere kvalitet, hvor Minimum, Extreme-Low og Low understøtter op til 1M Triangle, og de tilgængelige antal flader afhænger af niveauet. I Hyper3D API angiver `quality_override` antallet af flader, mens `mesh_mode` angiver Quad/Raw. Auto vælger de anbefalede indstillinger: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
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.
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/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"
  }
}
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/fast.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt