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

Hunyuan 3D Pro Image to 3D

التكامل

معرّف النموذج hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/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
Tencent من صورة إلى 3D #3d#hunyuan#image-to-3d

ينشئ نموذجًا ثلاثي الأبعاد من صورة أمامية مع زوايا إضافية اختيارية، والتحكم في عدد الأوجه وPBR

Tencent · 3D

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

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

إنشاء طلب

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

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

عنوان URL لصورة JPG أو PNG أو WEBP للمنظر الأمامي، بدقة من 128 إلى 5000px وحجم لا يتجاوز 8 MB. يُفضَّل استخدام خلفية بسيطة وعنصر واحد يملأ أكثر من 50% من الإطار.

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

عنوان URL لصورة المنظر الخلفي، يُقدَّم اختياريًا؛ يُوصى بـ JPG/PNG.

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

عنوان URL لصورة المنظر الأيسر، يُقدَّم اختياريًا؛ يُوصى بـ JPG/PNG.

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

عنوان URL لصورة المنظر الأيمن، يُقدَّم اختياريًا؛ يُوصى بـ JPG/PNG.

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

عنوان URL لصورة المنظر العلوي، يُقدَّم اختياريًا ومتاح فقط في v3.1؛ يُوصى بـ JPG/PNG.

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

عنوان URL لصورة اختيارية للمنظر السفلي، مدعومة فقط في v3.1. يُوصى بـ JPG/PNG.

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

عنوان URL لصورة اختيارية متاحة فقط في v3.1، ويفضَّل أن تكون بتنسيق JPG/PNG. توفّر الصورة منظرًا بزاوية 45 درجة من الجهة الأمامية اليسرى.

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

عنوان URL لصورة اختيارية متاحة فقط في v3.1، ويفضَّل أن تكون بتنسيق JPG/PNG. توفّر الصورة منظرًا بزاوية 45 درجة من الجهة الأمامية اليمنى.

الافتراضي 500000

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

متقدم generate_type
generate_type الافتراضي Normal

اختر بين نموذج مُكسى بالخامات مع Normal ونموذج أبيض غير مُكسى بالخامات يعتمد على الهندسة فقط مع Geometry. في v3.1، لا يمكن اختيار LowPoly/Sketch.

POST /run/hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/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

حول Hunyuan 3D Pro Image to 3D

ينشئ نموذجًا ثلاثي الأبعاد من صورة أمامية مطلوبة، `input_image_url`. يمكن للصور الخلفية واليسرى واليمنى والعلوية والسفلية وزاويتين بقدر 45 درجة إضافة التفاصيل. يحدد `generate_type` نموذجًا منسجًا أو نموذجًا أبيض هندسيًا فقط، ويضيف `enable_pbr` مواد PBR، بينما يتراوح `face_count` من 40,000 إلى 1,500,000. يعيد GLB وروابط لصيغ أخرى وصورة مصغرة.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
input_image_urlمطلوب
النوعurl · image
عنوان URL لصورة JPG أو PNG أو WEBP للمنظر الأمامي، بدقة من 128 إلى 5000px وحجم لا يتجاوز 8 MB. يُفضَّل استخدام خلفية بسيطة وعنصر واحد يملأ أكثر من 50% من الإطار.
back_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر الخلفي، يُقدَّم اختياريًا؛ يُوصى بـ JPG/PNG.
left_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر الأيسر، يُقدَّم اختياريًا؛ يُوصى بـ JPG/PNG.
right_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر الأيمن، يُقدَّم اختياريًا؛ يُوصى بـ JPG/PNG.
top_image_urlاختياري
النوعurl · image
عنوان URL لصورة المنظر العلوي، يُقدَّم اختياريًا ومتاح فقط في v3.1؛ يُوصى بـ JPG/PNG.
bottom_image_urlاختياري
النوعurl · image
عنوان URL لصورة اختيارية للمنظر السفلي، مدعومة فقط في v3.1. يُوصى بـ JPG/PNG.
left_front_image_urlاختياري
النوعurl · image
عنوان URL لصورة اختيارية متاحة فقط في v3.1، ويفضَّل أن تكون بتنسيق JPG/PNG. توفّر الصورة منظرًا بزاوية 45 درجة من الجهة الأمامية اليسرى.
right_front_image_urlاختياري
النوعurl · image
عنوان URL لصورة اختيارية متاحة فقط في v3.1، ويفضَّل أن تكون بتنسيق JPG/PNG. توفّر الصورة منظرًا بزاوية 45 درجة من الجهة الأمامية اليمنى.
generate_typeاختياري
النوعenum
الافتراضيNormal
NormalGeometry
اختر بين نموذج مُكسى بالخامات مع Normal ونموذج أبيض غير مُكسى بالخامات يعتمد على الهندسة فقط مع Geometry. في v3.1، لا يمكن اختيار LowPoly/Sketch.
enable_pbrاختياري
النوعboolean
الافتراضيfalse
مفتاح توليد PBR، غير نشط عندما يكون generate_type هو Geometry. بخلاف ذلك، يؤدي تفعيله إلى إضافة خامات معدنية وخشونة وخامة normal إلى المواد المُولَّدة.
face_countاختياري
النوعinteger
الافتراضي500000
40,000 – 1,500,000
عدد أوجه المضلع المطلوب، من 40,000 إلى 1,500,000. افتراضيًا 500,000.
مطلوب

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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, mtl, texture, usdz}روابط إلى النموذج ثلاثي الأبعاد بتنسيقات مختلفة.
seed
integer | nullقيمة البذرة المستخدمة أثناء التوليد.

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

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