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

Hyper3d

التكامل

معرّف النموذج hyper3d/rodin/v2
# 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/v2?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 إخراج بدقة 4Kسريع #image-to-3d#text-to-3d

تحويل Rodin v2 من النص أو الصورة إلى 3D مع ما يصل إلى 5 صور إدخال وإعدادات شبكة رباعية أو مثلثة ومعاينة عرض

Hyper3D · 3D

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

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

إنشاء طلب

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

0 / 1024

وجّه التوليد بموجّه نصي، أو اتركه فارغًا في وضع Image-to-3D ليشتق الذكاء الاصطناعي الموجّه من صورك.

متقدم input_image_urls · geometry_file_format · material · quality_mesh_option · addons · seed · use_original_alpha · TAPose · preview_render · bbox_condition
أفلت ملفًا، أو

عناوين URL للصور المصدر، بحد أقصى 5 صور، وهي إلزامية في وضع Image-to-3D لتوليد النموذج.

geometry_file_format الافتراضي glb

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

material الافتراضي All

اختيار المادة، حيث يشمل All البديلين: يستخدم PBR نهجًا قائمًا على الفيزياء لإضاءة واقعية، بينما يستخدم Shaded مواد بسيطة وإضاءة مخبوزة.

quality_mesh_option الافتراضي 500K Triangle

اختيار مدمج للشبكة والجودة، يُحوّله Hyper3D API إلى `quality_override` باستخدام الجزء الرقمي من الخيار، وإلى `mesh_mode` باستخدام 'Raw' إذا احتوى الخيار على 'Triangle'، أو 'Quad' خلاف ذلك. يفضّل Quad الأسطح الملساء، بينما يفضّل Triangle الهندسة التفصيلية.

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

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

حجم صندوق الإحاطة، معبّرًا عنه كمصفوفة مرتبة [width, height, length].

POST /run/hyper3d/rodin/v2?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/v2?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

ينشئ نماذج ثلاثية الأبعاد من مطالبة (حتى 1024 حرفًا) وما يصل إلى 5 صور في `input_image_urls`. يوفر `quality_mesh_option` شبكات رباعية من 4K إلى 50K وشبكات مثلثة من 2K إلى 500K. يدعم `material` بقيم PBR أو Shaded أو All، و`TAPose` و`use_original_alpha` و`preview_render`.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring
الافتراضي
≤ 1,024 حرفًا
وجّه التوليد بموجّه نصي، أو اتركه فارغًا في وضع Image-to-3D ليشتق الذكاء الاصطناعي الموجّه من صورك.
input_image_urlsاختياري
النوعurl[] · image
عناوين URL للصور المصدر، بحد أقصى 5 صور، وهي إلزامية في وضع Image-to-3D لتوليد النموذج.
use_original_alphaاختياري
النوعboolean
الافتراضيfalse
يتحكم في الاحتفاظ بقنوات الشفافية لصور المدخل عند توليد محتوى ثلاثي الأبعاد.
seedاختياري
النوعinteger | null
0 – 65,535
بذرة عشوائية اختيارية، بنطاق من 0–65535.
geometry_file_formatاختياري
النوعenum
الافتراضيglb
glbusdzfbxobjstl
تنسيق ملف الهندسة، ويُختار من glb وusdz وfbx وobj وstl؛ وقيمته الافتراضية glb.
materialاختياري
النوعenum
الافتراضيAll
PBRShadedAll
اختيار المادة، حيث يشمل All البديلين: يستخدم PBR نهجًا قائمًا على الفيزياء لإضاءة واقعية، بينما يستخدم Shaded مواد بسيطة وإضاءة مخبوزة.
quality_mesh_optionاختياري
النوعenum
الافتراضي500K Triangle
4K Quad8K Quad18K Quad50K Quad2K Triangle20K Triangle150K Triangle500K Triangle
اختيار مدمج للشبكة والجودة، يُحوّله Hyper3D API إلى `quality_override` باستخدام الجزء الرقمي من الخيار، وإلى `mesh_mode` باستخدام 'Raw' إذا احتوى الخيار على 'Triangle'، أو 'Quad' خلاف ذلك. يفضّل Quad الأسطح الملساء، بينما يفضّل Triangle الهندسة التفصيلية.
TAPoseاختياري
النوعboolean
الافتراضيfalse
إعداد وضعية الشخصية لتسهيل التجهيز والتحريك في البرامج الثلاثية الأبعاد: يؤدي تفعيله إلى توليد الشخصيات في وضعية T-pose أو A-pose.
bbox_conditionاختياري
النوعinteger[]
حجم صندوق الإحاطة، معبّرًا عنه كمصفوفة مرتبة [width, height, length].
addonsاختياري
النوعstring | null
يوفّر HighPack نماذج عالية المضلعات ويرفع دقة الخامة من 1K الافتراضية إلى 4K.
preview_renderاختياري
النوعboolean
الافتراضيfalse
مفتاح تبديل للعرض المسبق يضيف صورة تُظهر النموذج الثلاثي الأبعاد المُولّد إلى ملفات النموذج المُسلّمة.
مطلوب

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2",
  "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
    },
    "model_meshes": [
      {
        "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}ملف يحتوي على الكائن الثلاثي الأبعاد المُولّد.
model_meshes
array of object {url, content_type, file_name, file_size}ملفات كائنات ثلاثية الأبعاد إضافية يُولّدها Hyper3D ويعيدها بالإضافة إلى model_mesh.
seed
integerالبذرة المطبقة أثناء التوليد.
textures
array of object {url, content_type, file_name, file_size, width, height}الخامات المُنتجة للكائن الثلاثي الأبعاد.

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