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

Hi3D Image to 3D

التكامل

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

هذا الطلب: ≈⁨‏0.50 $⁩ 500 رصيد API · ≈ ⁨‏53.79 ₽⁩ تشغيله في هذه الصفحة

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

تحويل صورة واحدة إلى شبكة 3D مع إصدارات Hitem3D قابلة للاختيار وتنوعات عمودية وصيغ تصدير عديدة

Hitem3D · 3D

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

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

إنشاء طلب

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

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

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

resolution

دقة التوليد، افتراضيًا إلى توصية النموذج: 1024 لـ v1.5/v2.0 وطبقة السرعة خلاف ذلك. الخيارات المتاحة هي 512 و1024 و1536 و1536pro لـ v1.5/v2.0؛ و1536fast و1536pro لـ v2.1؛ و1536 لـ scene-portraitv1.5؛ و1536pro لـ scene-portraitv2.0؛ و1536profast و1536pro لـ scene-portraitv2.1.

متقدم model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model الافتراضي hitem3dv2.1

محدد نموذج التوليد: اختر من عائلة 'scene-portrait*' المضبوطة للصور الشخصية والشخصيات، أو عائلة 'hitem3d*' متعددة الأغراض.

export_format الافتراضي glb

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

عدد الأوجه المطلوب للنموذج المُولَّد، متجاوزًا توصية الشريك المستندة إلى الدقة. عند حذفه، يختار الشريك تلك التوصية، مثل 500k عند 512، أو 1M عند 1024، أو 2M عند 1536.

POST /run/hitem3d/hi3d/image-to-3d?wait=20 عرض السعر → ⁨‏0.50 $⁩
# 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/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

ينشئ نموذجًا ثلاثي الأبعاد من صورة واحدة (PNG أو JPEG أو WebP، حتى 20MB). يتضمن خيار `model` إصدارات عامة وأخرى مهيأة للصور العمودية، وتعتمد قيم `resolution` المسموح بها عليه. يمكن تفعيل خرائط الخامة وPBR، ويتراوح `face_count` من 100,000 إلى 2,000,000، ويكون التصدير glb أو obj أو stl أو fbx أو usdz.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
modelاختياري
النوعenum
الافتراضيhitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
محدد نموذج التوليد: اختر من عائلة 'scene-portrait*' المضبوطة للصور الشخصية والشخصيات، أو عائلة 'hitem3d*' متعددة الأغراض.
resolutionاختياري
النوعenum
512102415361536pro1536fast1536profast
دقة التوليد، افتراضيًا إلى توصية النموذج: 1024 لـ v1.5/v2.0 وطبقة السرعة خلاف ذلك. الخيارات المتاحة هي 512 و1024 و1536 و1536pro لـ v1.5/v2.0؛ و1536fast و1536pro لـ v2.1؛ و1536 لـ scene-portraitv1.5؛ و1536pro لـ scene-portraitv2.0؛ و1536profast و1536pro لـ scene-portraitv2.1.
enable_textureاختياري
النوعboolean
الافتراضيtrue
يحدد ما إذا كانت الخامات تُولَّد مع الهندسة.
enable_pbrاختياري
النوعboolean
الافتراضيtrue
يحدد ما إذا كانت خرائط مواد PBR تُنشأ إلى جانب الخامة.
face_countاختياري
النوعinteger | null
100,000 – 2,000,000
عدد الأوجه المطلوب للنموذج المُولَّد، متجاوزًا توصية الشريك المستندة إلى الدقة. عند حذفه، يختار الشريك تلك التوصية، مثل 500k عند 512، أو 1M عند 1024، أو 2M عند 1536.
export_formatاختياري
النوعenum
الافتراضيglb
glbobjstlfbxusdz
التنسيق المستخدم لحفظ النموذج المُولَّد.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص السلامة لصور المدخل: تتطلب true إجراء فحص سلامة قبل بدء معالجة الصورة.
image_urlمطلوب image
النوعurl · image
قدّم صورة المدخل عبر عنوان URL بصيغة PNG أو JPEG أو WebP، وبحجم لا يتجاوز 20 MB.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/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": 500,
    "usd": "0.50",
    "charged": 500,
    "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/image-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt