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

Hunyuan3d V3 · Image to 3D

التكامل

معرّف النموذج 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"

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

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

تحويل Hunyuan3D V3 من الصورة إلى 3D مع زوايا خلفية ويسرى ويمنى اختيارية ووضعَي PBR وLowPoly

Tencent · 3D

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

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

إنشاء طلب

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

•مطلوب
أفلت ملفًا، أو

عنوان URL لصورة تُستخدم لتوليد نموذج ثلاثي الأبعاد.

أفلت ملفًا، أو

عنوان URL لصورة المنظر الخلفي، تُوفّر اختياريًا لتحسين إعادة البناء الثلاثي الأبعاد.

أفلت ملفًا، أو

عنوان URL لصورة المنظر الأيسر، تُوفّر اختياريًا لتحسين إعادة البناء الثلاثي الأبعاد.

أفلت ملفًا، أو

عنوان URL لصورة المنظر الأيمن، تُوفّر اختياريًا لتحسين إعادة البناء الثلاثي الأبعاد.

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/image-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://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"

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

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

حول Hunyuan3d V3 · Image to 3D

ينشئ نموذجًا ثلاثي الأبعاد من `input_image_url`، مع `back_image_url` و`left_image_url` و`right_image_url` اختيارية لتحسين إعادة البناء. يحدد `generate_type` الخيارات Normal أو LowPoly أو Geometry (غير منسج)، ويختار `polygon_type` مثلثًا أو رباعيًّا لـLowPoly. يضيف `enable_pbr` مواد PBR، ويتراوح `face_count` من 40000 إلى 1500000. يعيد GLB وروابط الصيغ الأخرى وصورة مصغرة.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
input_image_urlمطلوب
النوعurl · image
عنوان URL لصورة تُستخدم لتوليد نموذج ثلاثي الأبعاد.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
back_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر الخلفي، تُوفّر اختياريًا لتحسين إعادة البناء الثلاثي الأبعاد.
left_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر الأيسر، تُوفّر اختياريًا لتحسين إعادة البناء الثلاثي الأبعاد.
right_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر الأيمن، تُوفّر اختياريًا لتحسين إعادة البناء الثلاثي الأبعاد.
enable_pbrاختياري
النوعboolean
الافتراضيfalse
توليد مواد PBR ما لم تكن generate_type هي Geometry، وفي هذه الحالة لا يؤثر هذا الإعداد.
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`.
مطلوب

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

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"
  }
}
ملفاتك، خيارككل 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/image-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt