Langkau ke kandungan

Hunyuan3d V3 · Text to 3D

Integrasikan

ID model hunyuan3d-v3/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.34 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Tencent Teks ke 3D

Hunyuan3D V3 teks kepada 3D dengan output Normal, LowPoly atau Geometry serta pilihan 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 88 / 1024

Prompt penjanaan yang membenarkan sehingga 1024 aksara UTF-8 untuk menyatakan kandungan 3D yang perlu dicipta.

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/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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 · Text to 3D

Menjana model 3D daripada `prompt` sehingga 1024 aksara tanpa memerlukan imej. `generate_type` memilih model Normal bertekstur, pengurangan LowPoly atau model Geometry putih; `polygon_type` menetapkan triangle atau quadrilateral untuk LowPoly. `enable_pbr` menambah bahan PBR dan `face_count` berjulat dari 40000 hingga 1500000.

Parameter

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 1,024 aksara
Prompt penjanaan yang membenarkan sehingga 1024 aksara UTF-8 untuk menyatakan kandungan 3D yang perlu dicipta.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
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.
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

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/text-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": {
    "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: Teks ke 3D

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