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

Hyper3D - Rodin V2.5 - Image to 3D - Fast

التكامل

معرّف النموذج hyper3d/rodin/v2.5/fast
# 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/hyper3d/rodin/v2.5/fast?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

الحصول على مفتاح API
Hyper3D من صورة إلى 3D إخراج بدقة 4Kسريع #image-to-3d

تحويل أسرع من الصورة إلى 3D باستخدام Rodin V2.5، محدود بأدنى ثلاثة مستويات للنمذجة السريعة

Hyper3D · 3D

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

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

إنشاء طلب

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

0 / 1024

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

متقدم images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition
image_urls
أفلت ملفًا، أو · حتى 5

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

geometry_file_format الافتراضي glb

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

material الافتراضي Shaded

اختيار مخرج المادة: اختر None للهندسة بلا خامات، أو All لتلقي كلا نوعي المادة. للإضاءة الواقعية مع مواد قائمة على الفيزياء، اختر PBR؛ وللإضاءة المخبوزة دون خرائط PBR، اختر Shaded.

texture_mode

اختر جودة الخامة صراحةً أو اترك الاختيار لـ API، الذي يستخدم قيمة افتراضية مناسبة للمستوى.

الافتراضي Gen-2.5-Extreme-Low

مستوى التوليد؛ يفرض Gen-2.5-Minimum الوضع الأدنى وشبكة 50K Triangle بصرف النظر عن `quality_mesh_option`. تتوفر تفاصيل المستوى في [توثيق Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

الافتراضي Auto

اختر الجودة مع طوبولوجيا الشبكة: يفضّل Quad الأسطح الملساء، بينما يفضّل Triangle التفاصيل الهندسية. تهدف نقطة النهاية السريعة أساسًا إلى الاختبار وبناء النماذج الأولية، مع حد 20K؛ استخدم نقطة النهاية القياسية للشبكات الأعلى جودة، حيث تدعم Minimum وExtreme-Low وLow ما يصل إلى 1M Triangle، مع اعتماد أعداد الأوجه المتاحة على المستوى. في Hyper3D API، يحدد `quality_override` عدد الأوجه، بينما يحدد `mesh_mode` قيمة Quad/Raw. يختار Auto الإعدادات الموصى بها: 1. Gen-2.5-Minimum → 20K Triangle؛ 2. Gen-2.5-Extreme-Low → 20K Triangle؛ 3. Gen-2.5-Low → 20K Triangle.

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

حدّد الحجم الأقصى للنموذج المُولّد باستخدام ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 عرض السعر → ⁨‏0.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/hyper3d/rodin/v2.5/fast?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Hyper3D - Rodin V2.5 - Image to 3D - Fast

ينشئ نموذجًا ثلاثي الأبعاد من صورة واحدة إلى خمس صور في `image_urls`، مع `prompt` اختيارية. يقتصر `tier` على Minimum وExtreme-Low (الافتراضي) وLow، ولا تتجاوز خيارات الشبكة 20K وجهًا. المادة الافتراضية Shaded. صيغ الإخراج هي glb أو usdz أو fbx أو obj أو stl.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlsاختياري images
النوعurl[] · image
≤ 5 عناصر
عناوين URL للصور المصدر، بحد أقصى 5 صور، وهي إلزامية في وضع Image-to-3D لتوليد النموذج.
tierاختياري
النوعenum
الافتراضيGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
مستوى التوليد؛ يفرض Gen-2.5-Minimum الوضع الأدنى وشبكة 50K Triangle بصرف النظر عن `quality_mesh_option`. تتوفر تفاصيل المستوى في [توثيق Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptاختياري
النوعstring
الافتراضي
≤ 1,024 حرفًا
وجّه التوليد بالنص، أو اترك هذا فارغًا في وضع 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
الافتراضيShaded
PBRShadedAllNone
اختيار مخرج المادة: اختر None للهندسة بلا خامات، أو All لتلقي كلا نوعي المادة. للإضاءة الواقعية مع مواد قائمة على الفيزياء، اختر PBR؛ وللإضاءة المخبوزة دون خرائط PBR، اختر Shaded.
quality_mesh_optionاختياري
النوعenum
الافتراضيAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
اختر الجودة مع طوبولوجيا الشبكة: يفضّل Quad الأسطح الملساء، بينما يفضّل Triangle التفاصيل الهندسية. تهدف نقطة النهاية السريعة أساسًا إلى الاختبار وبناء النماذج الأولية، مع حد 20K؛ استخدم نقطة النهاية القياسية للشبكات الأعلى جودة، حيث تدعم Minimum وExtreme-Low وLow ما يصل إلى 1M Triangle، مع اعتماد أعداد الأوجه المتاحة على المستوى. في Hyper3D API، يحدد `quality_override` عدد الأوجه، بينما يحدد `mesh_mode` قيمة Quad/Raw. يختار Auto الإعدادات الموصى بها: 1. Gen-2.5-Minimum → 20K Triangle؛ 2. Gen-2.5-Extreme-Low → 20K Triangle؛ 3. Gen-2.5-Low → 20K Triangle.
texture_modeاختياري
النوعenum
legacyextreme-lowlowmediumhigh
اختر جودة الخامة صراحةً أو اترك الاختيار لـ API، الذي يستخدم قيمة افتراضية مناسبة للمستوى.
enable_creative_modeاختياري
النوعboolean
الافتراضيfalse
وضع التوليد الإبداعي، المكافئ لضبط `geometry_instruct_mode` على `creative` في Hyper3D API. يؤدي تفعيله إلى جعل التوليد أكثر متانة دون التضحية باتساق المخرج.
hd_textureاختياري
النوعboolean
الافتراضيfalse
يتحكم في المعالجة اللاحقة المتقدمة للخامة لتحسين الدقة البصرية.
texture_delightاختياري
النوعboolean
الافتراضيfalse
يزيل الإضاءة واللمعان المضمّنين من الخامات المُولّدة.
is_microاختياري
النوعboolean
الافتراضيfalse
يضيف تفاصيل هندسية أدق على المستوى المجهري؛ ولا يسري إلا عند `tier="Gen-2.5-Extreme-High"`.
TAPoseاختياري
النوعboolean
الافتراضيfalse
إعداد وضعية الشخصية لتسهيل التجهيز والتحريك في البرامج الثلاثية الأبعاد: يؤدي تفعيله إلى توليد الشخصيات في وضعية T-pose أو A-pose.
bbox_conditionاختياري
النوعobject
حدّد الحجم الأقصى للنموذج المُولّد باستخدام ControlNet.
bbox_condition.widthاختياري
النوعinteger
الافتراضي0
1 – 2,048
قيد عرض صندوق الإحاطة على المحور x.
bbox_condition.heightاختياري
النوعinteger
الافتراضي0
1 – 2,048
قيد ارتفاع صندوق الإحاطة على المحور y.
bbox_condition.lengthاختياري
النوعinteger
الافتراضي0
1 – 2,048
قيد طول صندوق الإحاطة على المحور z.
preview_renderاختياري
النوعboolean
الافتراضيfalse
مفتاح تبديل للعرض المسبق يضيف صورة تُظهر النموذج الثلاثي الأبعاد المُولّد إلى ملفات النموذج المُسلّمة.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "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.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}ملف يحتوي على الكائن الثلاثي الأبعاد المُولّد.
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}الخامات المُنتجة للكائن الثلاثي الأبعاد.

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

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