Vai al contenuto

Hunyuan3d V3 · Image to 3D

Integra

ID del modello hunyuan3d-v3/image-to-3d
# 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/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

File come nell'esempio: 0,375 $ 375 crediti API · ≈ 40,34 ₽ i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Tencent Da immagine a 3D

Hunyuan3D V3 da immagine a 3D con viste posteriore/sinistra/destra opzionali, modalità PBR e low-poly

Tencent · 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.

•obbligatorio
Trascina un file oppure

URL dell'immagine usata per la generazione del modello 3D.

Trascina un file oppure

URL dell'immagine della vista posteriore, fornito facoltativamente per migliorare la ricostruzione 3D.

Trascina un file oppure

URL dell'immagine della vista sinistra, fornito facoltativamente per migliorare la ricostruzione 3D.

Trascina un file oppure

URL dell'immagine della vista destra, fornito facoltativamente per migliorare la ricostruzione 3D.

generate_type predefinito Normal

Modalità di generazione: `Normal` produce un modello con texture; `LowPoly` riduce i poligoni; `Geometry` produce un modello bianco senza texture.

predefinito 500000

Numero desiderato di facce, da 40,000 a 1,500,000.

Avanzate polygon_type · enable_safety_checker
polygon_type predefinito triangle

Tipo di poligono, applicato solo se `GenerateType` è `LowPoly`.

POST /run/hunyuan3d-v3/image-to-3d?wait=20 preventivo → 0,375 $
# 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/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

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 Hunyuan3d V3 · Image to 3D

Crea un modello 3D da `input_image_url`, con `back_image_url`, `left_image_url` e `right_image_url` opzionali per migliorare la ricostruzione. `generate_type` seleziona Normal, LowPoly o Geometry (senza texture) e `polygon_type` sceglie triangle o quadrilateral per LowPoly. `enable_pbr` aggiunge materiali PBR e `face_count` varia da 40000 a 1500000. Restituisce un GLB, URL per altri formati e una miniatura.

Parametri

NomeTipo PredefinitoConsentiti Descrizione
input_image_urlobbligatorio
Tipourl · image
URL dell'immagine usata per la generazione del modello 3D.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
back_image_urlfacoltativo
Tipourl · image
URL dell'immagine della vista posteriore, fornito facoltativamente per migliorare la ricostruzione 3D.
left_image_urlfacoltativo
Tipourl · image
URL dell'immagine della vista sinistra, fornito facoltativamente per migliorare la ricostruzione 3D.
right_image_urlfacoltativo
Tipourl · image
URL dell'immagine della vista destra, fornito facoltativamente per migliorare la ricostruzione 3D.
enable_pbrfacoltativo
Tipoboolean
Predefinitofalse
Genera materiali PBR, a meno che generate_type non sia Geometry; in tal caso questa impostazione non ha effetto.
face_countfacoltativo
Tipointeger
Predefinito500000
40.000 – 1.500.000
Numero desiderato di facce, da 40,000 a 1,500,000.
generate_typefacoltativo
Tipoenum
PredefinitoNormal
NormalLowPolyGeometry
Modalità di generazione: `Normal` produce un modello con texture; `LowPoly` riduce i poligoni; `Geometry` produce un modello bianco senza texture.
polygon_typefacoltativo
Tipoenum
Predefinitotriangle
trianglequadrilateral
Tipo di poligono, applicato solo se `GenerateType` è `LowPoly`.
obbligatorio

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": "hunyuan3d-v3/image-to-3d",
  "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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "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
    },
    "thumbnail": {
      "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_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
  },
  "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"
  }
}
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_glb
object {url, content_type, file_name, file_size}File GLB contenente l'oggetto 3D generato.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura che mostra un'anteprima del modello generato.
model_urls
object {glb, fbx, obj, usdz}Collegamenti al modello 3D in vari formati.
seed
integer | nullValore seed usato durante la generazione.

Altri modelli: Da immagine a 3D

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/hunyuan3d-v3/image-to-3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt