Preskoči na vsebino

Hunyuan 3D Pro Image to 3D

Integracija

ID modela hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/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"

Datoteke, kot je primer: 0,375 $ 375 API kreditov · ≈ 40,24 ₽ vaše datoteke se izmerijo pred zagonom Zaženi na tej strani

Pridobi ključ API
Tencent Slika v 3D #3d#hunyuan#image-to-3d

Iz sprednje slike in neobveznih dodatnih pogledov izdela 3D-model z nadzorom števila ploskev in PBR

Tencent · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno
Spustite datoteko ali

URL slike JPG, PNG ali WEBP s čelnim pogledom, z ločljivostjo od 128 do 5000px in velikostjo največ 8 MB. Priporočeno je preprosto ozadje in en predmet, ki zapolnjuje več kot 50% sličice.

Spustite datoteko ali

URL slike z zadnjim pogledom, po želji; priporočena sta JPG/PNG.

Spustite datoteko ali

URL slike z levim pogledom, po želji; priporočena sta JPG/PNG.

Spustite datoteko ali

URL slike z desnim pogledom, po želji; priporočena sta JPG/PNG.

Spustite datoteko ali

URL slike s pogledom od zgoraj, po želji in na voljo samo v v3.1; priporočena sta JPG/PNG.

Spustite datoteko ali

URL izbirne slike s pogledom od spodaj, podprt samo v v3.1. Priporočena sta JPG/PNG.

Spustite datoteko ali

Izbirni URL slike, na voljo samo v v3.1, po možnosti v obliki JPG/PNG. Slika zagotavlja 45-stopinjski pogled s sprednje leve strani.

Spustite datoteko ali

Izbirni URL slike, na voljo samo v v3.1, po možnosti v obliki JPG/PNG. Slika zagotavlja 45-stopinjski pogled s sprednje desne strani.

privzeto 500000

Želeno število poligonskih ploskev, od 40,000 do 1,500,000. Privzeto 500,000.

Napredno generate_type
generate_type privzeto Normal

Izbirajte med teksturiranim modelom z Normal in neteksturiranim belim modelom samo z geometrijo z Geometry. V v3.1 LowPoly/Sketch ni mogoče izbrati.

POST /run/hunyuan-3d/v3.1/pro/image-to-3d?wait=20 cena → 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/hunyuan-3d/v3.1/pro/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"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Hunyuan 3D Pro Image to 3D

Iz zahtevane sprednje slike `input_image_url` ustvari 3D-model. Neobvezni zadnji, levi, desni, zgornji, spodnji in dva pogleda pod kotom 45 stopinj lahko dodajo podrobnosti. `generate_type` izbere teksturiran model ali bel model samo z geometrijo, `enable_pbr` doda materiale PBR, `face_count` pa je od 40,000 do 1,500,000. Vrne GLB, URL-je drugih formatov in sličico.

Parametri

ImeVrsta PrivzetoDovoljeno Opis
input_image_urlobvezno
Vrstaurl · image
URL slike JPG, PNG ali WEBP s čelnim pogledom, z ločljivostjo od 128 do 5000px in velikostjo največ 8 MB. Priporočeno je preprosto ozadje in en predmet, ki zapolnjuje več kot 50% sličice.
back_image_urlneobvezno
Vrstaurl · image
URL slike z zadnjim pogledom, po želji; priporočena sta JPG/PNG.
left_image_urlneobvezno
Vrstaurl · image
URL slike z levim pogledom, po želji; priporočena sta JPG/PNG.
right_image_urlneobvezno
Vrstaurl · image
URL slike z desnim pogledom, po želji; priporočena sta JPG/PNG.
top_image_urlneobvezno
Vrstaurl · image
URL slike s pogledom od zgoraj, po želji in na voljo samo v v3.1; priporočena sta JPG/PNG.
bottom_image_urlneobvezno
Vrstaurl · image
URL izbirne slike s pogledom od spodaj, podprt samo v v3.1. Priporočena sta JPG/PNG.
left_front_image_urlneobvezno
Vrstaurl · image
Izbirni URL slike, na voljo samo v v3.1, po možnosti v obliki JPG/PNG. Slika zagotavlja 45-stopinjski pogled s sprednje leve strani.
right_front_image_urlneobvezno
Vrstaurl · image
Izbirni URL slike, na voljo samo v v3.1, po možnosti v obliki JPG/PNG. Slika zagotavlja 45-stopinjski pogled s sprednje desne strani.
generate_typeneobvezno
Vrstaenum
PrivzetoNormal
NormalGeometry
Izbirajte med teksturiranim modelom z Normal in neteksturiranim belim modelom samo z geometrijo z Geometry. V v3.1 LowPoly/Sketch ni mogoče izbrati.
enable_pbrneobvezno
Vrstaboolean
Privzetofalse
Preklop generiranja PBR, neaktiven, ko je generate_type Geometry. Sicer njegova omogočitev doda ustvarjenim materialom teksture kovinskosti, hrapavosti in normal.
face_countneobvezno
Vrstainteger
Privzeto500000
40.000 – 1.500.000
Želeno število poligonskih ploskev, od 40,000 do 1,500,000. Privzeto 500,000.
obvezno

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
model_glb
object {url, content_type, file_name, file_size}Datoteka GLB z ustvarjenim 3D-objektom.
thumbnail
object {url, content_type, file_name, file_size} | nullSličica s predogledom ustvarjenega modela.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Povezave do 3D-modela v različnih oblikah.
seed
integer | nullVrednost semena, uporabljena med generiranjem.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/hunyuan-3d/v3.1/pro/image-to-3d.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt