Přejít na obsah

Hunyuan3d V3 · Image to 3D

Integrace

ID modelu 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"

Soubory jako v příkladu: 0,375 $ 375 kreditů API · ≈ 40,34 ₽ vaše soubory se před spuštěním změří Spustit na této stránce

Získat API klíč
Tencent Obrázek na 3D

Hunyuan3D V3 převádí obrázek na 3D s volitelnými zadními, levými a pravými pohledy, PBR a režimy low-poly

Tencent · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné
Přetáhněte soubor nebo

URL obrázku použitého pro generování 3D modelu.

Přetáhněte soubor nebo

URL obrázku zadního pohledu, volitelně dodaného ke zlepšení 3D rekonstrukce.

Přetáhněte soubor nebo

URL obrázku levého pohledu, volitelně dodaného ke zlepšení 3D rekonstrukce.

Přetáhněte soubor nebo

URL obrázku pravého pohledu, volitelně dodaného ke zlepšení 3D rekonstrukce.

generate_type výchozí Normal

Režim generování: `Normal` vytváří texturovaný model; `LowPoly` snižuje počet polygonů; `Geometry` vytváří neotexturovaný bílý model.

výchozí 500000

Požadovaný počet ploch v rozsahu 40,000 až 1,500,000.

Pokročilé polygon_type · enable_safety_checker
polygon_type výchozí triangle

Typ polygonů, použitý pouze pokud je `GenerateType` nastaven na `LowPoly`.

POST /run/hunyuan3d-v3/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/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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Hunyuan3d V3 · Image to 3D

Vytvoří 3D model z `input_image_url`, s volitelnými `back_image_url`, `left_image_url` a `right_image_url` pro lepší rekonstrukci. `generate_type` vybere Normal, LowPoly nebo Geometry (bez textury) a `polygon_type` určuje triangle nebo quadrilateral pro LowPoly. `enable_pbr` přidá materiály PBR a `face_count` je v rozsahu 40000 až 1500000. Vrací GLB, URL pro další formáty a náhled.

Parametry

NázevTyp VýchozíPovolené Popis
input_image_urlpovinné
Typurl · image
URL obrázku použitého pro generování 3D modelu.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Kontrolu lze uvolnit nastavením na false, pokud je volající autorizován.
back_image_urlvolitelné
Typurl · image
URL obrázku zadního pohledu, volitelně dodaného ke zlepšení 3D rekonstrukce.
left_image_urlvolitelné
Typurl · image
URL obrázku levého pohledu, volitelně dodaného ke zlepšení 3D rekonstrukce.
right_image_urlvolitelné
Typurl · image
URL obrázku pravého pohledu, volitelně dodaného ke zlepšení 3D rekonstrukce.
enable_pbrvolitelné
Typboolean
Výchozífalse
Generuje materiály PBR, pokud generate_type není Geometry; v takovém případě toto nastavení nemá žádný účinek.
face_countvolitelné
Typinteger
Výchozí500000
40 000 – 1 500 000
Požadovaný počet ploch v rozsahu 40,000 až 1,500,000.
generate_typevolitelné
Typenum
VýchozíNormal
NormalLowPolyGeometry
Režim generování: `Normal` vytváří texturovaný model; `LowPoly` snižuje počet polygonů; `Geometry` vytváří neotexturovaný bílý model.
polygon_typevolitelné
Typenum
Výchozítriangle
trianglequadrilateral
Typ polygonů, použitý pouze pokud je `GenerateType` nastaven na `LowPoly`.
povinné

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
model_glb
object {url, content_type, file_name, file_size}Soubor GLB obsahující vygenerovaný 3D objekt.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura s náhledem vygenerovaného modelu.
model_urls
object {glb, fbx, obj, usdz}Odkazy na 3D model v různých formátech.
seed
integer | nullHodnota seedu použitá během generování.

Další modely: Obrázek na 3D

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/hunyuan3d-v3/image-to-3d.md. Všechny modely a návody: https://doitong.com/developers/llms.txt