Pāriet uz saturu

Hunyuan 3D Pro Image to 3D

Integrēt

Modeļa id 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"

Faili, piemēram, paraugā: 0,375 $ 375 API kredīti · ≈ 40,24 ₽ jūsu faili tiek izmērīti pirms izpildes Izpildīt šajā lapā

Iegūt API atslēgu
Tencent Attēls uz 3D #3d#hunyuan#image-to-3d

Izveido 3D modeli no priekšpuses attēla un neobligātiem papildu skatiem, kontrolējot skaldņu skaitu un PBR

Tencent · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts
Nometiet failu vai

Priekšskata JPG, PNG vai WEBP attēla URL ar izšķirtspēju no 128 līdz 5000px un izmēru līdz 8 MB. Ieteicams vienkāršs fons un viens objekts, kas aizpilda vairāk nekā 50% kadra.

Nometiet failu vai

Aizmugures skata attēla URL, pēc izvēles; ieteicams JPG/PNG.

Nometiet failu vai

Kreisā sāna attēla URL, pēc izvēles; ieteicams JPG/PNG.

Nometiet failu vai

Labā sāna attēla URL, pēc izvēles; ieteicams JPG/PNG.

Nometiet failu vai

Skata no augšas attēla URL, pēc izvēles, pieejams tikai v3.1; ieteicams JPG/PNG.

Nometiet failu vai

Izvēles skata no apakšas attēla URL, atbalstīts tikai v3.1. Ieteicams JPG/PNG.

Nometiet failu vai

Izvēles attēla URL, pieejams tikai v3.1, vēlams JPG/PNG formātā. Attēls nodrošina 45 grādu skatu no kreisās priekšpuses.

Nometiet failu vai

Izvēles attēla URL, pieejams tikai v3.1, vēlams JPG/PNG formātā. Attēls nodrošina 45 grādu skatu no labās priekšpuses.

noklusējums 500000

Vēlamais daudzstūra skaldņu skaits no 40,000 līdz 1,500,000. Noklusējums ir 500,000.

Papildu generate_type
generate_type noklusējums Normal

Izvēlieties teksturētu modeli ar Normal vai neteksturētu baltu modeli tikai ar ģeometriju ar Geometry. V3.1 versijā LowPoly/Sketch nevar atlasīt.

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"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Hunyuan 3D Pro Image to 3D

Izveido 3D modeli no obligāta priekšpuses attēla `input_image_url`. Papildu aizmugures, kreisās, labās, augšas, apakšas un divi 45 grādu skati var pievienot detaļas. `generate_type` izvēlas teksturētu modeli vai baltu, tikai ģeometrijas modeli, `enable_pbr` pievieno PBR materiālus, bet `face_count` ir no 40,000 līdz 1,500,000. Atgriež GLB, citu formātu URL un sīktēlu.

Parametri

NosaukumsTips NoklusējumsAtļauts Apraksts
input_image_urlobligāts
Tipsurl · image
Priekšskata JPG, PNG vai WEBP attēla URL ar izšķirtspēju no 128 līdz 5000px un izmēru līdz 8 MB. Ieteicams vienkāršs fons un viens objekts, kas aizpilda vairāk nekā 50% kadra.
back_image_urlneobligāts
Tipsurl · image
Aizmugures skata attēla URL, pēc izvēles; ieteicams JPG/PNG.
left_image_urlneobligāts
Tipsurl · image
Kreisā sāna attēla URL, pēc izvēles; ieteicams JPG/PNG.
right_image_urlneobligāts
Tipsurl · image
Labā sāna attēla URL, pēc izvēles; ieteicams JPG/PNG.
top_image_urlneobligāts
Tipsurl · image
Skata no augšas attēla URL, pēc izvēles, pieejams tikai v3.1; ieteicams JPG/PNG.
bottom_image_urlneobligāts
Tipsurl · image
Izvēles skata no apakšas attēla URL, atbalstīts tikai v3.1. Ieteicams JPG/PNG.
left_front_image_urlneobligāts
Tipsurl · image
Izvēles attēla URL, pieejams tikai v3.1, vēlams JPG/PNG formātā. Attēls nodrošina 45 grādu skatu no kreisās priekšpuses.
right_front_image_urlneobligāts
Tipsurl · image
Izvēles attēla URL, pieejams tikai v3.1, vēlams JPG/PNG formātā. Attēls nodrošina 45 grādu skatu no labās priekšpuses.
generate_typeneobligāts
Tipsenum
NoklusējumsNormal
NormalGeometry
Izvēlieties teksturētu modeli ar Normal vai neteksturētu baltu modeli tikai ar ģeometriju ar Geometry. V3.1 versijā LowPoly/Sketch nevar atlasīt.
enable_pbrneobligāts
Tipsboolean
Noklusējumsfalse
PBR ģenerēšanas slēdzis, neaktīvs, ja generate_type ir Geometry. Pretējā gadījumā tā iespējošana pievieno ģenerētajiem materiāliem metāliskuma, raupjuma un normal tekstūras.
face_countneobligāts
Tipsinteger
Noklusējums500000
40 000 – 1 500 000
Vēlamais daudzstūra skaldņu skaits no 40,000 līdz 1,500,000. Noklusējums ir 500,000.
obligāts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
model_glb
object {url, content_type, file_name, file_size}GLB fails ar ģenerēto 3D objektu.
thumbnail
object {url, content_type, file_name, file_size} | nullSīktēls ar ģenerētā modeļa priekšskatījumu.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Saites uz 3D modeli dažādos formātos.
seed
integer | nullĢenerēšanas laikā izmantotā sēklas vērtība.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/hunyuan-3d/v3.1/pro/image-to-3d.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt