Lompat ke konten

Hunyuan 3D Pro Image to 3D

Integrasikan

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

File seperti contoh: $0,375 375 kredit API · ≈ ₽40,24 file Anda diukur sebelum dijalankan Jalankan di halaman ini

Dapatkan kunci API
Tencent Gambar ke 3D #3d#hunyuan#image-to-3d

Membangun model 3D dari gambar depan dan tampilan tambahan opsional, dengan kontrol jumlah face dan PBR

Tencent · 3D

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib
Jatuhkan file, atau

URL gambar JPG, PNG, atau WEBP tampak depan, dengan resolusi 128 hingga 5000px dan ukuran tidak lebih dari 8 MB. Gunakan latar belakang sederhana dan satu objek yang memenuhi lebih dari 50% bingkai.

Jatuhkan file, atau

URL gambar tampak belakang, opsional; JPG/PNG direkomendasikan.

Jatuhkan file, atau

URL gambar tampak kiri, opsional; JPG/PNG direkomendasikan.

Jatuhkan file, atau

URL gambar tampak kanan, opsional; JPG/PNG direkomendasikan.

Jatuhkan file, atau

URL gambar tampak atas, opsional dan hanya tersedia di v3.1; JPG/PNG direkomendasikan.

Jatuhkan file, atau

URL gambar tampak bawah opsional, hanya didukung di v3.1. JPG/PNG direkomendasikan.

Jatuhkan file, atau

URL gambar opsional yang hanya tersedia di v3.1, sebaiknya dalam format JPG/PNG. Gambar menyediakan tampilan 45 derajat dari kiri depan.

Jatuhkan file, atau

URL gambar opsional yang hanya tersedia di v3.1, sebaiknya dalam format JPG/PNG. Gambar menyediakan tampilan 45 derajat dari kanan depan.

bawaan 500000

Jumlah wajah poligon yang diinginkan, dari 40,000 hingga 1,500,000. Bawaan 500,000.

Lanjutan generate_type
generate_type bawaan Normal

Pilih antara model bertekstur dengan Normal dan model putih tanpa tekstur yang hanya berisi geometri dengan Geometry. Di v3.1, LowPoly/Sketch tidak dapat dipilih.

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

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Hunyuan 3D Pro Image to 3D

Membuat model 3D dari gambar depan wajib, `input_image_url`. Tampilan belakang, kiri, kanan, atas, bawah, dan dua tampilan 45 derajat bersifat opsional untuk menambah detail. `generate_type` memilih model bertekstur atau model putih yang hanya berisi geometri, `enable_pbr` menambahkan material PBR, dan `face_count` berkisar dari 40,000 hingga 1,500,000. Mengembalikan GLB, URL format lain, dan thumbnail.

Parameter

NamaTipe BawaanDiizinkan Deskripsi
input_image_urlwajib
Tipeurl · image
URL gambar JPG, PNG, atau WEBP tampak depan, dengan resolusi 128 hingga 5000px dan ukuran tidak lebih dari 8 MB. Gunakan latar belakang sederhana dan satu objek yang memenuhi lebih dari 50% bingkai.
back_image_urlopsional
Tipeurl · image
URL gambar tampak belakang, opsional; JPG/PNG direkomendasikan.
left_image_urlopsional
Tipeurl · image
URL gambar tampak kiri, opsional; JPG/PNG direkomendasikan.
right_image_urlopsional
Tipeurl · image
URL gambar tampak kanan, opsional; JPG/PNG direkomendasikan.
top_image_urlopsional
Tipeurl · image
URL gambar tampak atas, opsional dan hanya tersedia di v3.1; JPG/PNG direkomendasikan.
bottom_image_urlopsional
Tipeurl · image
URL gambar tampak bawah opsional, hanya didukung di v3.1. JPG/PNG direkomendasikan.
left_front_image_urlopsional
Tipeurl · image
URL gambar opsional yang hanya tersedia di v3.1, sebaiknya dalam format JPG/PNG. Gambar menyediakan tampilan 45 derajat dari kiri depan.
right_front_image_urlopsional
Tipeurl · image
URL gambar opsional yang hanya tersedia di v3.1, sebaiknya dalam format JPG/PNG. Gambar menyediakan tampilan 45 derajat dari kanan depan.
generate_typeopsional
Tipeenum
BawaanNormal
NormalGeometry
Pilih antara model bertekstur dengan Normal dan model putih tanpa tekstur yang hanya berisi geometri dengan Geometry. Di v3.1, LowPoly/Sketch tidak dapat dipilih.
enable_pbropsional
Tipeboolean
Bawaanfalse
Toggle pembuatan PBR, tidak aktif saat generate_type adalah Geometry. Jika tidak, mengaktifkannya menambahkan tekstur metallic, roughness, dan normal ke material yang dibuat.
face_countopsional
Tipeinteger
Bawaan500000
40.000 – 1.500.000
Jumlah wajah poligon yang diinginkan, dari 40,000 hingga 1,500,000. Bawaan 500,000.
wajib

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
model_glb
object {url, content_type, file_name, file_size}File GLB yang berisi objek 3D yang dibuat.
thumbnail
object {url, content_type, file_name, file_size} | nullThumbnail yang menampilkan pratinjau model yang dibuat.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Tautan ke model 3D dalam berbagai format.
seed
integer | nullNilai seed yang digunakan selama pembuatan.

Model lainnya: Gambar ke 3D

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/hunyuan-3d/v3.1/pro/image-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt