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

Hunyuan 3D Rapid Image to 3D

التكامل

معرّف النموذج hunyuan-3d/v3.1/rapid/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/rapid/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.225 $⁩ 225 رصيد API · ≈ ⁨‏24.18 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Tencent من صورة إلى 3D #3d#hunyuan#image-to-3d

تحويل سريع من صورة إلى 3D ينشئ نموذجًا من صورة أمامية واحدة، مع PBR اختياري أو شبكة غير منسجة

Tencent · 3D

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

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

إنشاء طلب

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

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

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

متقدم enable_geometry
POST /run/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20 عرض السعر → ⁨‏0.225 $⁩
# 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/rapid/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 Rapid Image to 3D

ينشئ نموذجًا ثلاثي الأبعاد من صورة أمامية واحدة (`input_image_url`، من 128 إلى 5000 px، حتى 8MB، بصيغ JPG أو PNG أو WEBP). يعمل بأفضل أداء مع خلفية بسيطة وعنصر واحد يملأ أكثر من نصف الإطار. يضيف `enable_pbr` أنسجة معدنية وخشونة وطبيعية، بينما يعيد `enable_geometry` نموذجًا أبيض غير منسج بصيغة GLB. تشمل المخرجات النموذج وروابط كل صيغة والنسيج وملف MTL وصورة مصغرة.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
input_image_urlمطلوب
النوعurl · image
قدّم صورة للمنظر الأمامي عبر عنوان URL؛ يُوصى بخلفية بسيطة وعنصر واحد يغطي أكثر من 50% من الإطار. استخدم JPG أو PNG أو WEBP بدقة بين 128 و5000px، مع حد لحجم الملف يبلغ 8 MB؛ ولترميز base64، يُوصى بـ 6 MB أو أقل.
enable_pbrاختياري
النوعboolean
الافتراضيfalse
مفتاح توليد PBR، غير نشط عندما يكون enable_geometry هو True. بخلاف ذلك، يؤدي تفعيله إلى إضافة خامات معدنية وخشونة وخامة normal إلى المواد المُولَّدة.
enable_geometryاختياري
النوعboolean
الافتراضيfalse
مفتاح توليد يعتمد على الهندسة فقط، يعطّل دعم OBJ، ويجعل المخرج GLB افتراضيًا ويتجاهل enable_pbr عند تفعيله. يكون النموذج الناتج أبيض ومن دون خامات.
مطلوب

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/rapid/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": 225,
    "usd": "0.225",
    "charged": 225,
    "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
    },
    "material_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
    },
    "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
      }
    }
  },
  "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} | nullملف يحتوي على النموذج ثلاثي الأبعاد المُولَّد، باستخدام GLB عند توفره وOBJ خلاف ذلك.
material_mtl
object {url, content_type, file_name, file_size} | nullملف MTL يحتوي على مواد نموذج OBJ.
texture
object {url, content_type, file_name, file_size} | nullصورة توفّر خامة النموذج ثلاثي الأبعاد.
thumbnail
object {url, content_type, file_name, file_size} | nullصورة مصغرة تعرض معاينة للنموذج المُولَّد.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}روابط إلى النموذج ثلاثي الأبعاد بتنسيقات مختلفة.

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

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