Langkau ke kandungan

Hunyuan3d V3 · Image to 3D

Integrasikan

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

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

Dapatkan kunci API
Tencent Imej ke 3D

Hunyuan3D V3 imej kepada 3D dengan paparan belakang/kiri/kanan pilihan, PBR dan mod low-poly

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 yang digunakan untuk penjanaan model 3D.

Lepaskan fail, atau

URL imej pandangan belakang, dibekalkan secara pilihan untuk memperbaik pembinaan semula 3D.

Lepaskan fail, atau

URL imej pandangan kiri, dibekalkan secara pilihan untuk memperbaik pembinaan semula 3D.

Lepaskan fail, atau

URL imej pandangan kanan, dibekalkan secara pilihan untuk memperbaik pembinaan semula 3D.

generate_type lalai Normal

Mod penjanaan: `Normal` menghasilkan model bertekstur; `LowPoly` mengurangkan poligon; `Geometry` menghasilkan model putih tanpa tekstur.

lalai 500000

Bilangan muka yang dikehendaki, antara 40,000 hingga 1,500,000.

Lanjutan polygon_type · enable_safety_checker
polygon_type lalai triangle

Jenis poligon, hanya digunakan jika `GenerateType` ialah `LowPoly`.

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

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 Hunyuan3d V3 · Image to 3D

Mencipta model 3D daripada `input_image_url`, dengan `back_image_url`, `left_image_url` dan `right_image_url` pilihan untuk meningkatkan pembinaan semula. `generate_type` memilih Normal, LowPoly atau Geometry (tanpa tekstur), dan `polygon_type` memilih triangle atau quadrilateral untuk LowPoly. `enable_pbr` menambah bahan PBR dan `face_count` berjulat dari 40000 hingga 1500000. Mengembalikan GLB, URL format lain dan lakaran kecil.

Parameter

NamaJenis LalaiDibenarkan Penerangan
input_image_urldiperlukan
Jenisurl · image
URL imej yang digunakan untuk penjanaan model 3D.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
back_image_urlpilihan
Jenisurl · image
URL imej pandangan belakang, dibekalkan secara pilihan untuk memperbaik pembinaan semula 3D.
left_image_urlpilihan
Jenisurl · image
URL imej pandangan kiri, dibekalkan secara pilihan untuk memperbaik pembinaan semula 3D.
right_image_urlpilihan
Jenisurl · image
URL imej pandangan kanan, dibekalkan secara pilihan untuk memperbaik pembinaan semula 3D.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Jana bahan PBR melainkan generate_type ialah Geometry; dalam keadaan itu, tetapan ini tiada kesan.
face_countpilihan
Jenisinteger
Lalai500000
40,000 – 1,500,000
Bilangan muka yang dikehendaki, antara 40,000 hingga 1,500,000.
generate_typepilihan
Jenisenum
LalaiNormal
NormalLowPolyGeometry
Mod penjanaan: `Normal` menghasilkan model bertekstur; `LowPoly` mengurangkan poligon; `Geometry` menghasilkan model putih tanpa tekstur.
polygon_typepilihan
Jenisenum
Lalaitriangle
trianglequadrilateral
Jenis poligon, hanya digunakan jika `GenerateType` ialah `LowPoly`.
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": "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"
  }
}
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, 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/hunyuan3d-v3/image-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt