مواد پر جائیں

Hyper3D - Rodin V2.5 - Image to 3D

انٹیگریٹ کریں

ماڈل id hyper3d/rodin/v2.5
# 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?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.40⁩ 400 API کریڈٹس · ≈ ⁨₽42.19⁩ اس صفحے پر چلائیں

API کلید حاصل کریں
Hyper3D تصویر سے 3D 4K آؤٹ پٹتیز #image-to-3d

Rodin V2.5 کے ساتھ تصویر سے 3D، زیادہ سے زیادہ 5 حوالہ جاتی تصاویر اور کوالٹی درجات کے انتخاب کے ساتھ

Hyper3D · 3D

آپ کا پہلا نتیجہ یہاں آئے گا

ذیل میں درخواست بنائیں اور اپنی API کلید کے ساتھ چلائیں۔ آؤٹ پٹس ہمارے اسٹوریج میں کاپی ہو جاتے ہیں، ہمیشہ کے لیے یا مفت میں 7 دن تک محفوظ رہتے ہیں۔

درخواست بنائیں

کنٹرولز ماڈل اسکیما سے تیار ہوتے ہیں۔ آپ کے بدلنے کے ساتھ کوڈ اور قیمت اپ ڈیٹ ہوتے ہیں۔

0 / 1024

متن سے تخلیق کی رہنمائی کریں، یا Image-to-3D mode میں اسے خالی چھوڑ کر ماڈل کو تصاویر سے خودکار طور پر پرامپٹ اخذ کرنے دیں۔

ایڈوانسڈ 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 · addons
image_urls
فائل ڈراپ کریں، یا · 5 تک

Source تصویر URLs، زیادہ سے زیادہ 5 تصاویر؛ ماڈل تخلیق کرنے کے لیے Image-to-3D mode میں لازمی۔

geometry_file_format ڈیفالٹ glb

Geometry فائل format، glb، usdz، fbx، obj، stl میں سے منتخب کیا جاتا ہے؛ ڈیفالٹ glb ہے۔

material ڈیفالٹ All

Material آؤٹ پٹ کا انتخاب: textures کے بغیر geometry کے لیے None، یا دونوں material variants کے لیے All منتخب کریں۔ حقیقت پسندانہ lighting اور physically based materials کے لیے PBR؛ PBR maps کے بغیر baked lighting کے لیے Shaded منتخب کریں۔

texture_mode

Texture quality واضح طور پر منتخب کریں یا API کو انتخاب کرنے دیں، جو tier کے مطابق موزوں ڈیفالٹ استعمال کرتا ہے۔

ڈیفالٹ Gen-2.5-High

Mesh-detail tier؛ tier بڑھانے سے detail بڑھتی ہے، مگر Gen-2.5-Minimum خودکار طور پر minimum mode فعال کرتا ہے اور quality_mesh_option سے قطع نظر 50K Triangle نافذ کرتا ہے۔ مزید تفصیلات [دستاویزات](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) میں ہیں۔

ڈیفالٹ Auto

Mesh topology اور quality؛ دستیاب face counts tier کے مطابق متعین ہوتے ہیں: Extreme-Low، Low اور Medium زیادہ سے زیادہ 1M Triangle، جبکہ High اور Extreme-High، 20K Triangle سے 2M Triangle تک support کرتے ہیں۔ Auto یہ settings لاگو کرتا ہے: 1. Gen-2.5-Minimum → 50K Triangle؛ 2. Gen-2.5-Extreme-Low → 50K Triangle؛ 3. Gen-2.5-Low → 50K Triangle؛ 4. Gen-2.5-Medium → 500K Triangle؛ 5. Gen-2.5-High → 500K Triangle؛ Gen-2.5-Extreme-High → 1M Triangle۔ Manual selection میں Quad ہموار surfaces اور Triangle تفصیلی geometry کو ترجیح دیتا ہے؛ Hyper3D API کو topology `mesh_mode` (Quad/Raw) اور face count `quality_override` کے طور پر ملتا ہے۔

اختیاری تصادفی seed، 0–65535 کی range کے ساتھ۔

ControlNet کے ذریعے تخلیق کردہ ماڈل کا زیادہ سے زیادہ سائز محدود کریں۔

اختیاری add-on selection، فہرست یا صرف ایک add-on کے لیے single value کے طور پر فراہم کیا جاتا ہے۔

POST /run/hyper3d/rodin/v2.5?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.ru/v1/run/hyper3d/rodin/v2.5?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"

یہ درخواست چلائیں

آپ کی key اسی براؤزر میں رہتی ہے: یہ صرف Doitong API کو بھیجی جاتی ہے اور صرف اس صورت میں localStorage میں محفوظ ہوتی ہے جب آپ Remember منتخب کریں۔ API کلید حاصل کریں

Hyper3D - Rodin V2.5 - Image to 3D کے بارے میں

`image_urls` میں ایک سے پانچ تصاویر سے 3D ماڈل بناتا ہے، اختیاری `prompt` زیادہ سے زیادہ 1024 حروف کا ہو سکتا ہے۔ چھ درجات Gen-2.5-Minimum سے Gen-2.5-Extreme-High تک ہیں، ڈیفالٹ High ہے۔ اختیارات میں ہندسہ فارمیٹ (glb, usdz, fbx, obj, stl)، `material`، چوکور یا مثلث میش سائز، rig-friendly کرداروں کے لیے `TAPose` اور `hd_texture` شامل ہیں۔

پیرامیٹرز

معیاری نام یا مقامی نام میں سے صرف ایک بھیجیں، دونوں نہیں۔ معیاری نام

نامقسم ڈیفالٹمجاز تفصیل
promptاختیاری
قسمstring
ڈیفالٹ
≤ 1,024 کریکٹرز
متن سے تخلیق کی رہنمائی کریں، یا Image-to-3D mode میں اسے خالی چھوڑ کر ماڈل کو تصاویر سے خودکار طور پر پرامپٹ اخذ کرنے دیں۔
image_urlsاختیاری images
قسمurl[] · image
≤ 5 آئٹمز
Source تصویر URLs، زیادہ سے زیادہ 5 تصاویر؛ ماڈل تخلیق کرنے کے لیے Image-to-3D mode میں لازمی۔
tierاختیاری
قسمenum
ڈیفالٹGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Mesh-detail tier؛ tier بڑھانے سے detail بڑھتی ہے، مگر Gen-2.5-Minimum خودکار طور پر minimum mode فعال کرتا ہے اور quality_mesh_option سے قطع نظر 50K Triangle نافذ کرتا ہے۔ مزید تفصیلات [دستاویزات](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) میں ہیں۔
use_original_alphaاختیاری
قسمboolean
ڈیفالٹfalse
3D content تخلیق کرتے وقت input-image transparency channels برقرار رکھنے کو کنٹرول کرتا ہے۔
seedاختیاری
قسمinteger | null
0 – 65,535
اختیاری تصادفی seed، 0–65535 کی range کے ساتھ۔
geometry_file_formatاختیاری
قسمenum
ڈیفالٹglb
glbusdzfbxobjstl
Geometry فائل format، glb، usdz، fbx، obj، stl میں سے منتخب کیا جاتا ہے؛ ڈیفالٹ glb ہے۔
materialاختیاری
قسمenum
ڈیفالٹAll
PBRShadedAllNone
Material آؤٹ پٹ کا انتخاب: textures کے بغیر geometry کے لیے None، یا دونوں material variants کے لیے All منتخب کریں۔ حقیقت پسندانہ lighting اور physically based materials کے لیے PBR؛ PBR maps کے بغیر baked lighting کے لیے Shaded منتخب کریں۔
quality_mesh_optionاختیاری
قسمenum
ڈیفالٹAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh topology اور quality؛ دستیاب face counts tier کے مطابق متعین ہوتے ہیں: Extreme-Low، Low اور Medium زیادہ سے زیادہ 1M Triangle، جبکہ High اور Extreme-High، 20K Triangle سے 2M Triangle تک support کرتے ہیں۔ Auto یہ settings لاگو کرتا ہے: 1. Gen-2.5-Minimum → 50K Triangle؛ 2. Gen-2.5-Extreme-Low → 50K Triangle؛ 3. Gen-2.5-Low → 50K Triangle؛ 4. Gen-2.5-Medium → 500K Triangle؛ 5. Gen-2.5-High → 500K Triangle؛ Gen-2.5-Extreme-High → 1M Triangle۔ Manual selection میں Quad ہموار surfaces اور Triangle تفصیلی geometry کو ترجیح دیتا ہے؛ Hyper3D API کو topology `mesh_mode` (Quad/Raw) اور face count `quality_override` کے طور پر ملتا ہے۔
texture_modeاختیاری
قسمenum
legacyextreme-lowlowmediumhigh
Texture quality واضح طور پر منتخب کریں یا API کو انتخاب کرنے دیں، جو tier کے مطابق موزوں ڈیفالٹ استعمال کرتا ہے۔
enable_creative_modeاختیاری
قسمboolean
ڈیفالٹfalse
Creative تخلیقی mode، Hyper3D API میں `geometry_instruct_mode` کو `creative` پر set کرنے کے برابر ہے۔ اسے فعال کرنے سے آؤٹ پٹ consistency قربان کیے بغیر تخلیق زیادہ robust ہو جاتی ہے۔
hd_textureاختیاری
قسمboolean
ڈیفالٹfalse
visual fidelity بہتر بنانے کے لیے ایڈوانسڈ texture post-processing کو کنٹرول کرتا ہے۔
texture_delightاختیاری
قسمboolean
ڈیفالٹfalse
تخلیق کردہ textures سے baked-in illumination اور highlights ہٹا دیتا ہے۔
is_microاختیاری
قسمboolean
ڈیفالٹfalse
micro scale پر زیادہ باریک geometric detail شامل کرتا ہے؛ صرف `tier="Gen-2.5-Extreme-High"` پر مؤثر ہوتا ہے۔
TAPoseاختیاری
قسمboolean
ڈیفالٹfalse
3D software میں آسان rigging اور animation کے لیے character pose setting؛ فعال کرنے پر characters T-pose یا A-pose میں تخلیق ہوتے ہیں۔
bbox_conditionاختیاری
قسمobject
ControlNet کے ذریعے تخلیق کردہ ماڈل کا زیادہ سے زیادہ سائز محدود کریں۔
bbox_condition.widthاختیاری
قسمinteger
ڈیفالٹ0
1 – 2,048
x axis کے ساتھ bounding box constraint کی width۔
bbox_condition.heightاختیاری
قسمinteger
ڈیفالٹ0
1 – 2,048
y axis کے ساتھ bounding box constraint کی height۔
bbox_condition.lengthاختیاری
قسمinteger
ڈیفالٹ0
1 – 2,048
z axis کے ساتھ bounding box constraint کی length۔
addonsاختیاری
قسمobject
اختیاری add-on selection، فہرست یا صرف ایک add-on کے لیے single value کے طور پر فراہم کیا جاتا ہے۔
addons.high_packاختیاری
قسمboolean
ڈیفالٹfalse
HighPack enhancement: Quad آؤٹ پٹ میں quality پیرامیٹر کے ذریعے مانگے گئے face count سے تقریباً 16 گنا faces ہوتے ہیں، اور textures ڈیفالٹ 2K کے بجائے 4K ریزولوشن استعمال کرتے ہیں۔
preview_renderاختیاری
قسمboolean
ڈیفالٹfalse
Preview-render toggle، جو delivered ماڈل فائل میں تخلیق کردہ 3D ماڈل دکھانے والی تصویر شامل کرتا ہے۔
enable_safety_checkerاختیاری
قسمboolean
ڈیفالٹtrue
false سیٹ کر کے اسکریننگ نرم کی جا سکتی ہے، بشرطیکہ کال کرنے والا مجاز ہو۔
لازمی معیاری نام، یہ بھی قبول ہے

فائل پیرامیٹرز عوامی https:// URL، 10 MB تک کی data: URI، یا اپ لوڈ کے file_url کو قبول کرتے ہیں۔ فائلیں

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5",
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
آپ کی فائلیں، آپ کا انتخابہر outputs[].url ہمارے اسٹوریج میں ایک کاپی ہے: ہمیشہ کے لیے محفوظ (فی GB-ماہ ادائیگی) یا مفت میں 7 دن تک، آپ کی اکاؤنٹ سیٹنگ یا ?storage= کے مطابق۔
ہر ماڈل میں ایک جیسی ساختtype، url، content_type، width، height اور duration، تصاویر، ویڈیو اور آڈیو سب کے لیے یکساں۔ output ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
model_mesh
object {url, content_type, file_name, file_size}تخلیق کردہ 3D object پر مشتمل فائل۔
model_meshes
array of object {url, content_type, file_name, file_size}Hyper3D کی تخلیق کردہ اضافی 3D object فائل، جو model_mesh کے علاوہ واپس کی جاتی ہے۔
seed
integerتخلیق کے دوران استعمال ہونے والا سیڈ۔
textures
array of object {url, content_type, file_name, file_size, width, height}3D object کے لیے تیار کردہ textures۔

مزید ماڈلز: تصویر سے 3D

AI ایجنٹس کے لیے: یہ صفحہ Markdown میں یہاں موجود ہے https://doitong.com/ur/developers/models/hyper3d/rodin/v2.5.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt