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

Hi3D Texture

التكامل

معرّف النموذج hitem3d/hi3d/texture
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hitem3d/hi3d/texture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ≈⁨‏0.30 $⁩ 300 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Hitem3D 3D #3d-to-3d

يضيف نسيجًا إلى شبكة GLB غير منسّجة باستخدام صورة مرجعية

Hitem3D · 3D

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

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

إنشاء طلب

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

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

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

resolution

اختر دقة الخامة أو اتركها غير محددة لاستخدام توصية النموذج. بالنسبة إلى scene-portraitv1.5، الخيار الوحيد هو 1536، بينما يدعم hitem3dv1.5 القيم 512 و1024 و1536 و1536pro.

•مطلوب

قدّم الهندسة المراد إكساؤها بالخامات عبر عنوان URL بتنسيق GLB؛ لا يُدعم أي تنسيق آخر. أحد المصادر المناسبة هو مخرج هندسة من صورة إلى 3D مُولَّد مع enable_texture=false.

متقدم model · export_format · enable_safety_checker
model الافتراضي hitem3dv1.5

إصدار النموذج المستخدم لإكساء الخامات. تتطلب مهمة الخامات المرحلية نموذج v1.5.

export_format الافتراضي glb

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

POST /run/hitem3d/hi3d/texture?wait=20 عرض السعر → ⁨‏0.30 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hitem3d/hi3d/texture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Hi3D Texture

يطبّق نسيجًا على هندسة GLB موجودة لا تحتوي إلا على الشكل الهندسي، باستخدام صورة مرجعية (PNG أو JPEG أو WebP، حتى 20MB). النماذج v1.5 فقط مدعومة: يوفر hitem3dv1.5 دقات من 512 إلى 1536pro، بينما يستخدم البديل العمودي 1536. صيغ التصدير هي glb وobj وstl وfbx وusdz.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
قدّم مرجع الخامات عبر عنوان URL، باستخدام صورة PNG أو JPEG أو WebP بحجم ملف أقصى يبلغ 20 MB.
mesh_urlمطلوب
النوعstring
قدّم الهندسة المراد إكساؤها بالخامات عبر عنوان URL بتنسيق GLB؛ لا يُدعم أي تنسيق آخر. أحد المصادر المناسبة هو مخرج هندسة من صورة إلى 3D مُولَّد مع enable_texture=false.
modelاختياري
النوعenum
الافتراضيhitem3dv1.5
hitem3dv1.5scene-portraitv1.5
إصدار النموذج المستخدم لإكساء الخامات. تتطلب مهمة الخامات المرحلية نموذج v1.5.
resolutionاختياري
النوعenum
512102415361536pro
اختر دقة الخامة أو اتركها غير محددة لاستخدام توصية النموذج. بالنسبة إلى scene-portraitv1.5، الخيار الوحيد هو 1536، بينما يدعم hitem3dv1.5 القيم 512 و1024 و1536 و1536pro.
export_formatاختياري
النوعenum
الافتراضيglb
glbobjstlfbxusdz
التنسيق المستخدم لحفظ النموذج المُولَّد.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص السلامة لصور المدخل: تتطلب true إجراء فحص سلامة قبل بدء معالجة الصورة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/texture",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/texture.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt