Langkau ke kandungan

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"

Fail seperti contoh: $0.375 375 kredit API · ≈ ₽40.24 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

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

Membina model 3D daripada imej depan serta paparan tambahan pilihan, dengan kawalan jumlah muka dan PBR

Tencent · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan
Lepaskan fail, atau

URL imej JPG, PNG atau WEBP pandangan hadapan, dengan resolusi dari 128 hingga 5000px dan saiz tidak melebihi 8 MB. Latar belakang ringkas dan satu objek yang memenuhi lebih daripada 50% bingkai adalah disyorkan.

Lepaskan fail, atau

URL imej pandangan belakang, pilihan; JPG/PNG disyorkan.

Lepaskan fail, atau

URL imej pandangan sisi kiri, pilihan; JPG/PNG disyorkan.

Lepaskan fail, atau

URL imej pandangan sisi kanan, pilihan; JPG/PNG disyorkan.

Lepaskan fail, atau

URL imej pandangan atas, pilihan dan hanya tersedia dalam v3.1; JPG/PNG disyorkan.

Lepaskan fail, atau

URL imej pandangan bawah pilihan, hanya disokong dalam v3.1. JPG/PNG disyorkan.

Lepaskan fail, atau

URL imej pilihan yang hanya tersedia dalam v3.1, sebaiknya dalam format JPG/PNG. Imej membekalkan pandangan 45 darjah dari hadapan kiri.

Lepaskan fail, atau

URL imej pilihan yang hanya tersedia dalam v3.1, sebaiknya dalam format JPG/PNG. Imej membekalkan pandangan 45 darjah dari hadapan kanan.

lalai 500000

Bilangan muka poligon yang dikehendaki, dari 40,000 hingga 1,500,000. Lalai kepada 500,000.

Lanjutan generate_type
generate_type lalai Normal

Pilih antara model bertekstur dengan Normal dan model putih tanpa tekstur, geometri sahaja dengan Geometry. Dalam v3.1, LowPoly/Sketch tidak boleh dipilih.

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

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Hunyuan 3D Pro Image to 3D

Mencipta model 3D daripada imej depan wajib, `input_image_url`. Paparan belakang, kiri, kanan, atas, bawah dan dua paparan 45 darjah boleh ditambah untuk perincian. `generate_type` memilih model bertekstur atau geometri putih tanpa tekstur, `enable_pbr` menambah bahan PBR, dan `face_count` berjulat dari 40,000 hingga 1,500,000. Mengembalikan GLB, URL format lain dan lakaran kecil.

Parameter

NamaJenis LalaiDibenarkan Penerangan
input_image_urldiperlukan
Jenisurl · image
URL imej JPG, PNG atau WEBP pandangan hadapan, dengan resolusi dari 128 hingga 5000px dan saiz tidak melebihi 8 MB. Latar belakang ringkas dan satu objek yang memenuhi lebih daripada 50% bingkai adalah disyorkan.
back_image_urlpilihan
Jenisurl · image
URL imej pandangan belakang, pilihan; JPG/PNG disyorkan.
left_image_urlpilihan
Jenisurl · image
URL imej pandangan sisi kiri, pilihan; JPG/PNG disyorkan.
right_image_urlpilihan
Jenisurl · image
URL imej pandangan sisi kanan, pilihan; JPG/PNG disyorkan.
top_image_urlpilihan
Jenisurl · image
URL imej pandangan atas, pilihan dan hanya tersedia dalam v3.1; JPG/PNG disyorkan.
bottom_image_urlpilihan
Jenisurl · image
URL imej pandangan bawah pilihan, hanya disokong dalam v3.1. JPG/PNG disyorkan.
left_front_image_urlpilihan
Jenisurl · image
URL imej pilihan yang hanya tersedia dalam v3.1, sebaiknya dalam format JPG/PNG. Imej membekalkan pandangan 45 darjah dari hadapan kiri.
right_front_image_urlpilihan
Jenisurl · image
URL imej pilihan yang hanya tersedia dalam v3.1, sebaiknya dalam format JPG/PNG. Imej membekalkan pandangan 45 darjah dari hadapan kanan.
generate_typepilihan
Jenisenum
LalaiNormal
NormalGeometry
Pilih antara model bertekstur dengan Normal dan model putih tanpa tekstur, geometri sahaja dengan Geometry. Dalam v3.1, LowPoly/Sketch tidak boleh dipilih.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Suis penjanaan PBR, tidak aktif apabila generate_type ialah Geometry. Selain itu, mendayakannya menambah tekstur metalik, kekasaran dan normal pada bahan yang dijana.
face_countpilihan
Jenisinteger
Lalai500000
40,000 – 1,500,000
Bilangan muka poligon yang dikehendaki, dari 40,000 hingga 1,500,000. Lalai kepada 500,000.
diperlukan

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_glb
object {url, content_type, file_name, file_size}Fail GLB yang mengandungi objek 3D yang dijana.
thumbnail
object {url, content_type, file_name, file_size} | nullLakaran kecil yang menunjukkan pratonton model yang dijana.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}Pautan ke model 3D dalam pelbagai format.
seed
integer | nullNilai seed yang digunakan semasa penjanaan.

Lebih banyak model: Imej ke 3D

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