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

Hyper3D Rodin

التكامل

معرّف النموذج hyper3d/rodin
# 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/hyper3d/rodin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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.40 $⁩ 400 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Hyper3D من صورة إلى 3D سريع #stylized

إنشاء Rodin ثلاثي الأبعاد من النص أو الصور مع مواد PBR أو مظللة ومستويات جودة

Hyper3D · 3D

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

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

إنشاء طلب

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

0 / 1024

توجيه التوليد المقدّم كنص؛ يتطلبه وضع Text-to-3D، بينما يمكن لوضع Image-to-3D الاستغناء عنه.

متقدم input_image_urls · condition_mode · geometry_file_format · material · quality · tier · addons · seed · use_hyper · TAPose · bbox_condition
أفلت ملفًا، أو

عناوين URL للصور المصدر؛ يتطلبها Image-to-3D، وقد يستخدمها Text-to-3D اختياريًا لتوليد النموذج.

condition_mode الافتراضي concat

طريقة تهيئة الصورة: ينشئ concat النموذج من مناظر متعددة لكائن واحد، دون ترتيب رفع مطلوب. أما fuse فيتطلب صورة واحدة أو أكثر وينشئ النموذج باستخراج سمات الكائن ودمجها عبر الصور.

geometry_file_format الافتراضي glb

تنسيق ملف الهندسة، ويُختار من glb وusdz وfbx وobj وstl؛ وقيمته الافتراضية glb.

material الافتراضي PBR

اختيار المادة: PBR أو Shaded، مع كون PBR هو الافتراضي.

quality الافتراضي medium

مستوى جودة التوليد: high أو medium أو low أو extra-low؛ وقيمته الافتراضية medium.

tier الافتراضي Regular

اختيار مستوى التوليد: استخدم Sketch لـ Rodin Sketch أو Regular لـ Rodin Regular.

إضافات توليد اختيارية؛ وقيمتها الافتراضية []. يوفّر الخيار HighPack المتاح نماذج عالية المضلعات ويرفع دقة الخامة من 1K الافتراضية إلى 4K.

بذرة عشوائية اختيارية، بنطاق من 0–65535.

مصفوفة صندوق الإحاطة، تُرتّب عادةً في 3 إدخالات: الطول على المحور X، والعرض على المحور Y، والارتفاع على المحور Z. تحدد هذه القيم أبعاد الصندوق وعامل التحجيم.

POST /run/hyper3d/rodin?wait=20 عرض السعر → ⁨‏0.40 $⁩
# 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/hyper3d/rodin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# 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

حول Hyper3D Rodin

ينشئ نماذج ثلاثية الأبعاد من مطالبة حتى 1024 حرفًا أو صور إدخال أو كليهما. تكون `condition_mode` هي fuse أو concat للإدخال متعدد الصور. تشمل الخيارات `quality` من extra-low إلى high، و`material` بقيمة PBR أو Shaded، و`tier` بقيمة Regular أو Sketch، و`TAPose` و`bbox_condition`، والتصدير بصيغ glb أو usdz أو fbx أو obj أو stl.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring
الافتراضي
≤ 1,024 حرفًا
توجيه التوليد المقدّم كنص؛ يتطلبه وضع Text-to-3D، بينما يمكن لوضع Image-to-3D الاستغناء عنه.
input_image_urlsاختياري
النوعurl[] · image
عناوين URL للصور المصدر؛ يتطلبها Image-to-3D، وقد يستخدمها Text-to-3D اختياريًا لتوليد النموذج.
condition_modeاختياري
النوعenum
الافتراضيconcat
fuseconcat
طريقة تهيئة الصورة: ينشئ concat النموذج من مناظر متعددة لكائن واحد، دون ترتيب رفع مطلوب. أما fuse فيتطلب صورة واحدة أو أكثر وينشئ النموذج باستخراج سمات الكائن ودمجها عبر الصور.
seedاختياري
النوعinteger | null
0 – 65,535
بذرة عشوائية اختيارية، بنطاق من 0–65535.
geometry_file_formatاختياري
النوعenum
الافتراضيglb
glbusdzfbxobjstl
تنسيق ملف الهندسة، ويُختار من glb وusdz وfbx وobj وstl؛ وقيمته الافتراضية glb.
materialاختياري
النوعenum
الافتراضيPBR
PBRShaded
اختيار المادة: PBR أو Shaded، مع كون PBR هو الافتراضي.
qualityاختياري
النوعenum
الافتراضيmedium
highmediumlowextra-low
مستوى جودة التوليد: high أو medium أو low أو extra-low؛ وقيمته الافتراضية medium.
use_hyperاختياري
النوعboolean
الافتراضيfalse
يتحكم في تصدير نموذج hyper-mode؛ وقيمته الافتراضية false.
tierاختياري
النوعenum
الافتراضيRegular
RegularSketch
اختيار مستوى التوليد: استخدم Sketch لـ Rodin Sketch أو Regular لـ Rodin Regular.
TAPoseاختياري
النوعboolean
الافتراضيfalse
يتحكم فيما إذا كان سيُولّد نموذج شبيهًا بالبشر في وضعية T/A.
bbox_conditionاختياري
النوعinteger[]
مصفوفة صندوق الإحاطة، تُرتّب عادةً في 3 إدخالات: الطول على المحور X، والعرض على المحور Y، والارتفاع على المحور Z. تحدد هذه القيم أبعاد الصندوق وعامل التحجيم.
addonsاختياري
النوعstring | null
إضافات توليد اختيارية؛ وقيمتها الافتراضية []. يوفّر الخيار HighPack المتاح نماذج عالية المضلعات ويرفع دقة الخامة من 1K الافتراضية إلى 4K.
مطلوب

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "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
    },
    "seed": 42,
    "textures": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "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}ملف يحتوي على الكائن الثلاثي الأبعاد المُولّد.
seed
integerالبذرة المطبقة أثناء التوليد.
textures
array of object {url, content_type, file_name, file_size, width, height}الخامات المُنتجة للكائن الثلاثي الأبعاد.

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/hyper3d/rodin.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt