Vai al contenuto

Hyper3D - Rodin V2.5 - Image to 3D

Integra

ID del modello 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"

Questa richiesta: 0,40 $ 400 crediti API Esegui in questa pagina

Ottieni la chiave API
Hyper3D Da immagine a 3D Output 4KVeloce #image-to-3d

Da immagine a 3D con Rodin V2.5 usando fino a 5 immagini di riferimento e una scelta di livelli di qualità

Hyper3D · 3D

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

0 / 1024

Guida la generazione con testo oppure lascia che il modello derivi automaticamente un prompt dalle immagini lasciando vuoto questo campo nella modalità Image-to-3D.

Avanzate 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
Trascina un file oppure · fino a 5

URL delle immagini sorgente, limitati a 5 immagini e obbligatori nella modalità Image-to-3D per generare il modello.

geometry_file_format predefinito glb

Formato del file geometrico, scelto tra glb, usdz, fbx, obj, stl; predefinito a glb.

material predefinito All

Selezione dell'output dei materiali: scegli None per la geometria senza texture oppure All per ricevere entrambe le varianti dei materiali. Per un'illuminazione realistica con materiali basati sulla fisica, scegli PBR; per l'illuminazione precalcolata senza mappe PBR, scegli Shaded.

texture_mode

Scegli esplicitamente la qualità delle texture oppure lascia la scelta all'API, che usa un valore predefinito adatto al livello.

predefinito Gen-2.5-High

Livello di dettaglio della mesh; aumentarlo aggiunge dettagli, ma Gen-2.5-Minimum attiva automaticamente la modalità minima e forza 50K Triangle indipendentemente da quality_mesh_option. Ulteriori dettagli sono disponibili nella [documentazione](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

predefinito Auto

Topologia e qualità della mesh, con numero di facce disponibile determinato dal livello: Extreme-Low, Low e Medium consentono fino a 1M Triangle; High ed Extreme-High supportano da 20K Triangle a 2M Triangle. Auto applica queste impostazioni consigliate: 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. Per la selezione manuale, Quad privilegia le superfici uniformi e Triangle la geometria dettagliata; l'API Hyper3D riceve la topologia come `mesh_mode` (Quad/Raw) e il numero di facce come `quality_override`.

Seed di randomizzazione facoltativo, nell'intervallo 0–65535.

Limita le dimensioni massime del modello generato usando un ControlNet.

Selezione facoltativa di componenti aggiuntivi, fornita come elenco o, per un solo componente, come singolo valore.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Hyper3D - Rodin V2.5 - Image to 3D

Costruisce un modello 3D da una a cinque immagini in `image_urls`, con un `prompt` opzionale fino a 1024 caratteri. I sei livelli vanno da Gen-2.5-Minimum a Gen-2.5-Extreme-High, con High come valore predefinito. Le opzioni includono il formato della geometria (glb, usdz, fbx, obj, stl), `material`, dimensioni della mesh quad o triangle, `TAPose` per personaggi adatti al rigging e `hd_texture`.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptfacoltativo
Tipostring
Predefinito
≤ 1024 caratteri
Guida la generazione con testo oppure lascia che il modello derivi automaticamente un prompt dalle immagini lasciando vuoto questo campo nella modalità Image-to-3D.
image_urlsfacoltativo images
Tipourl[] · image
≤ 5 elementi
URL delle immagini sorgente, limitati a 5 immagini e obbligatori nella modalità Image-to-3D per generare il modello.
tierfacoltativo
Tipoenum
PredefinitoGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Livello di dettaglio della mesh; aumentarlo aggiunge dettagli, ma Gen-2.5-Minimum attiva automaticamente la modalità minima e forza 50K Triangle indipendentemente da quality_mesh_option. Ulteriori dettagli sono disponibili nella [documentazione](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
use_original_alphafacoltativo
Tipoboolean
Predefinitofalse
Controlla la conservazione dei canali di trasparenza dell'immagine di input durante la generazione di contenuti 3D.
seedfacoltativo
Tipointeger | null
0 – 65.535
Seed di randomizzazione facoltativo, nell'intervallo 0–65535.
geometry_file_formatfacoltativo
Tipoenum
Predefinitoglb
glbusdzfbxobjstl
Formato del file geometrico, scelto tra glb, usdz, fbx, obj, stl; predefinito a glb.
materialfacoltativo
Tipoenum
PredefinitoAll
PBRShadedAllNone
Selezione dell'output dei materiali: scegli None per la geometria senza texture oppure All per ricevere entrambe le varianti dei materiali. Per un'illuminazione realistica con materiali basati sulla fisica, scegli PBR; per l'illuminazione precalcolata senza mappe PBR, scegli Shaded.
quality_mesh_optionfacoltativo
Tipoenum
PredefinitoAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Topologia e qualità della mesh, con numero di facce disponibile determinato dal livello: Extreme-Low, Low e Medium consentono fino a 1M Triangle; High ed Extreme-High supportano da 20K Triangle a 2M Triangle. Auto applica queste impostazioni consigliate: 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. Per la selezione manuale, Quad privilegia le superfici uniformi e Triangle la geometria dettagliata; l'API Hyper3D riceve la topologia come `mesh_mode` (Quad/Raw) e il numero di facce come `quality_override`.
texture_modefacoltativo
Tipoenum
legacyextreme-lowlowmediumhigh
Scegli esplicitamente la qualità delle texture oppure lascia la scelta all'API, che usa un valore predefinito adatto al livello.
enable_creative_modefacoltativo
Tipoboolean
Predefinitofalse
Modalità di generazione creativa, equivalente a `geometry_instruct_mode` impostato su `creative` nell'API Hyper3D. Abilitarla rende la generazione più robusta senza compromettere la coerenza dell'output.
hd_texturefacoltativo
Tipoboolean
Predefinitofalse
Controlla la post-elaborazione avanzata delle texture per migliorare la fedeltà visiva.
texture_delightfacoltativo
Tipoboolean
Predefinitofalse
Rimuove l'illuminazione e le luci precalcolate dalle texture generate.
is_microfacoltativo
Tipoboolean
Predefinitofalse
Aggiunge dettagli geometrici più fini a scala micro; ha effetto solo quando `tier="Gen-2.5-Extreme-High"`.
TAPosefacoltativo
Tipoboolean
Predefinitofalse
Impostazione della posa del personaggio per facilitare rigging e animazione nei software 3D: abilitarla genera personaggi in posa T o A.
bbox_conditionfacoltativo
Tipoobject
Limita le dimensioni massime del modello generato usando un ControlNet.
bbox_condition.widthfacoltativo
Tipointeger
Predefinito0
1 – 2048
Larghezza del vincolo del riquadro delimitatore lungo l'asse x.
bbox_condition.heightfacoltativo
Tipointeger
Predefinito0
1 – 2048
Altezza del vincolo del riquadro delimitatore lungo l'asse y.
bbox_condition.lengthfacoltativo
Tipointeger
Predefinito0
1 – 2048
Lunghezza del vincolo del riquadro delimitatore lungo l'asse z.
addonsfacoltativo
Tipoobject
Selezione facoltativa di componenti aggiuntivi, fornita come elenco o, per un solo componente, come singolo valore.
addons.high_packfacoltativo
Tipoboolean
Predefinitofalse
Potenziamento HighPack: l'output Quad ha circa 16 volte il numero di facce richiesto tramite il parametro quality e le texture usano la risoluzione 4K invece del valore predefinito 2K.
preview_renderfacoltativo
Tipoboolean
Predefinitofalse
Interruttore del rendering di anteprima che aggiunge un'immagine del modello 3D generato ai file del modello restituiti.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
model_mesh
object {url, content_type, file_name, file_size}File contenente l'oggetto 3D generato.
model_meshes
array of object {url, content_type, file_name, file_size}File aggiuntivi dell'oggetto 3D generati da Hyper3D e restituiti oltre a model_mesh.
seed
integerSeed applicato durante la generazione.
textures
array of object {url, content_type, file_name, file_size, width, height}Texture prodotte per l'oggetto 3D.

Altri modelli: Da immagine a 3D

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/hyper3d/rodin/v2.5.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt