Langkau ke kandungan

Hunyuan3d V3 · Sketch to 3D

Integrasikan

ID model hunyuan3d-v3/sketch-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/sketch-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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

Hunyuan3D V3 yang menukar lakaran atau seni garisan bersama prompt teks kepada model 3D

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 88 / 1024

Nyatakan atribut dalam prompt teks untuk kandungan 3D—contohnya bahan, warna atau kategorinya.

•diperlukan
Lepaskan fail, atau

URL lakaran atau imej seni garisan untuk ditukar kepada model 3D. Dimensi imej yang disokong adalah antara 128 × 128 hingga 5000 × 5000 piksel.

lalai 500000

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

Lanjutan enable_safety_checker
POST /run/hunyuan3d-v3/sketch-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/sketch-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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 · Sketch to 3D

Memerlukan imej lakaran atau seni garisan (`input_image_url`, 128x128 hingga 5000x5000 piksel) dan `prompt` sehingga 1024 aksara yang menerangkan warna, kategori dan bahan. `enable_pbr` mengaktifkan bahan PBR, dan `face_count` menetapkan jumlah poligon sasaran dari 40000 hingga 1500000. Mengembalikan fail GLB, URL format lain dan lakaran kecil.

Parameter

NamaJenis LalaiDibenarkan Penerangan
input_image_urldiperlukan
Jenisurl · image
URL lakaran atau imej seni garisan untuk ditukar kepada model 3D. Dimensi imej yang disokong adalah antara 128 × 128 hingga 5000 × 5000 piksel.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
promptdiperlukan
Jenisstring
≤ 1,024 aksara
Nyatakan atribut dalam prompt teks untuk kandungan 3D—contohnya bahan, warna atau kategorinya.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Suis untuk menjana bahan PBR.
face_countpilihan
Jenisinteger
Lalai500000
40,000 – 1,500,000
Bilangan muka yang dikehendaki, antara 40,000 hingga 1,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": "hunyuan3d-v3/sketch-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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/sketch-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt