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

Hi3D Image to 3D · v3.0

التكامل

معرّف النموذج hitem3d/hi3d/v3.0/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/hitem3d/hi3d/v3.0/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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"

ملفات مثل المثال: ⁨‏2.10 $⁩ 2,100 رصيد API · ≈ ⁨‏225.36 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

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

تحويل صورة واحدة إلى 3D باستخدام Hi3D v3.0، بجودة 2048 أو دقة master والتحكم في إزالة التظليل

Hitem3D · 3D

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

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

إنشاء طلب

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

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

قدّم صورة المدخل عبر عنوان URL بصيغة PNG أو JPEG أو WebP، وبحجم لا يتجاوز 20 MB.

resolution الافتراضي 2048quality

محدد دقة التوليد الذي يوازن بين الجودة والسرعة: اختر 2048master لأعلى جودة أو 2048quality الافتراضي لتوليد أسرع.

متقدم export_format · model · face_count · shading · enable_safety_checker
export_format الافتراضي glb

التنسيق المستخدم لحفظ النموذج المُولَّد.

الافتراضي hi3dv3.0

إصدار نموذج Hi3D v3.0 لنقطة النهاية هذه.

عدد الأوجه المطلوب، مع توصيات المزوّد البالغة 2,000,000 عند استخدام 2048quality و5,000,000 عند استخدام 2048master.

الافتراضي 0.5

شدة إزالة التظليل.

POST /run/hitem3d/hi3d/v3.0/image-to-3d?wait=20 عرض السعر → ⁨‏2.10 $⁩
# 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/hitem3d/hi3d/v3.0/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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

حول Hi3D Image to 3D · v3.0

ينشئ نموذجًا ثلاثي الأبعاد من صورة واحدة حتى 20MB. تكون قيمة `resolution` هي 2048quality أو 2048master، والأخيرة لأعلى جودة. يمكن أن يصل `face_count` إلى 5,000,000، وتحدد `shading` (من 0 إلى 1) شدة إزالة التظليل. تتوفر مفاتيح تبديل للنسيج وPBR، مع تصدير بصيغ glb أو obj أو stl أو fbx أو usdz.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
modelاختياري
النوعstring
الافتراضيhi3dv3.0
إصدار نموذج Hi3D v3.0 لنقطة النهاية هذه.
resolutionاختياري
النوعenum
الافتراضي2048quality
2048quality2048master
محدد دقة التوليد الذي يوازن بين الجودة والسرعة: اختر 2048master لأعلى جودة أو 2048quality الافتراضي لتوليد أسرع.
enable_textureاختياري
النوعboolean
الافتراضيtrue
يحدد ما إذا كانت الخامات تُولَّد مع الهندسة.
enable_pbrاختياري
النوعboolean
الافتراضيtrue
يحدد ما إذا كانت خرائط مواد PBR تُنشأ إلى جانب الخامة.
face_countاختياري
النوعinteger | null
100,000 – 5,000,000
عدد الأوجه المطلوب، مع توصيات المزوّد البالغة 2,000,000 عند استخدام 2048quality و5,000,000 عند استخدام 2048master.
export_formatاختياري
النوعenum
الافتراضيglb
glbobjstlfbxusdz
التنسيق المستخدم لحفظ النموذج المُولَّد.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص السلامة لصور المدخل: تتطلب true إجراء فحص سلامة قبل بدء معالجة الصورة.
image_urlمطلوب image
النوعurl · image
قدّم صورة المدخل عبر عنوان URL بصيغة PNG أو JPEG أو WebP، وبحجم لا يتجاوز 20 MB.
shadingاختياري
النوعnumber
الافتراضي0.5
0 – 1
شدة إزالة التظليل.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/v3.0/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": 2100,
    "usd": "2.10",
    "charged": 2100,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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
    }
  },
  "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_mesh
object {url, content_type, file_name, file_size}ملف يحتوي على النموذج ثلاثي الأبعاد المُولَّد.
thumbnail
object {url, content_type, file_name, file_size} | nullصورة معاينة للنموذج، تُقدَّم عند توفرها.

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

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