تخطّي إلى المحتوى

Hunyuan3d V3 · Text to 3D

التكامل

معرّف النموذج 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://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.375 $⁩ 375 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API

تحويل Hunyuan3D V3 من النص إلى 3D مع مخرجات Normal أو LowPoly أو Geometry وخيار PBR

Tencent · 3D

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب 88 / 1024

موجّه التوليد، ويسمح بما يصل إلى 1024 حرفًا بترميز UTF-8 لتحديد المحتوى الثلاثي الأبعاد المطلوب إنشاؤه.

generate_type الافتراضي Normal

وضع التوليد: تنتج `Normal` نموذجًا مزوّدًا بالخامات؛ وتقلل `LowPoly` المضلعات؛ وتنتج `Geometry` نموذجًا أبيض بلا خامات.

الافتراضي 500000

العدد المطلوب للأوجه، ويتراوح من 40,000 إلى 1,500,000.

متقدم polygon_type · enable_safety_checker
polygon_type الافتراضي triangle

نوع المضلعات، ويُطبّق فقط إذا كانت `GenerateType` هي `LowPoly`.

POST /run/hunyuan3d-v3/text-to-3d?wait=20 عرض السعر → ⁨‏0.375 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Hunyuan3d V3 · Text to 3D

ينشئ نموذجًا ثلاثي الأبعاد من `prompt` حتى 1024 حرفًا، من دون الحاجة إلى صورة. يختار `generate_type` نموذج Normal منسجًا أو نسخة LowPoly مخفّضة أو نموذج Geometry أبيض؛ ويحدد `polygon_type` مثلثًا أو رباعيًّا لـLowPoly. يضيف `enable_pbr` مواد PBR، ويتراوح `face_count` من 40000 إلى 1500000.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 1,024 حرفًا
موجّه التوليد، ويسمح بما يصل إلى 1024 حرفًا بترميز UTF-8 لتحديد المحتوى الثلاثي الأبعاد المطلوب إنشاؤه.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
enable_pbrاختياري
النوعboolean
الافتراضيfalse
مفتاح تبديل لتوليد مواد PBR.
face_countاختياري
النوعinteger
الافتراضي500000
40,000 – 1,500,000
العدد المطلوب للأوجه، ويتراوح من 40,000 إلى 1,500,000.
generate_typeاختياري
النوعenum
الافتراضيNormal
NormalLowPolyGeometry
وضع التوليد: تنتج `Normal` نموذجًا مزوّدًا بالخامات؛ وتقلل `LowPoly` المضلعات؛ وتنتج `Geometry` نموذجًا أبيض بلا خامات.
polygon_typeاختياري
النوعenum
الافتراضيtriangle
trianglequadrilateral
نوع المضلعات، ويُطبّق فقط إذا كانت `GenerateType` هي `LowPoly`.
مطلوب

المخرجات

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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
model_glb
object {url, content_type, file_name, file_size}ملف GLB يحتوي على الكائن ثلاثي الأبعاد المُولَّد.
thumbnail
object {url, content_type, file_name, file_size} | nullصورة مصغرة تعرض معاينة للنموذج المُولَّد.
model_urls
object {glb, fbx, obj, usdz}روابط إلى النموذج ثلاثي الأبعاد بتنسيقات مختلفة.
seed
integer | nullقيمة البذرة المستخدمة أثناء التوليد.

مزيد من النماذج: من نص إلى 3D

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/hunyuan3d-v3/text-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt