مواد پر جائیں

Hyper3D - Rodin V2.5 - Text to 3D

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

ماڈل id hyper3d/rodin/v2.5/text-to-3d
# 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 کریڈٹس · ≈ ⁨₽43.03⁩ اس صفحے پر چلائیں

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

Rodin V2.5 کے ساتھ متن سے 3D، چھ درجات میں، 1024 حروف تک کے پرامپٹ سے

Hyper3D · 3D

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

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

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

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

•لازمی 88 / 1024

ماڈل کی تخلیق کی رہنمائی کرنے والی متنی instructions؛ Text-to-3D mode میں لازمی۔

ایڈوانسڈ geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
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 کے ذریعے تخلیق کردہ ماڈل کا زیادہ سے زیادہ سائز محدود کریں۔

ضرورت پڑنے پر لاگو کیے جانے والے اضافی options۔

POST /run/hyper3d/rodin/v2.5/text-to-3d?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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 - Text to 3D کے بارے میں

لازمی `prompt`، زیادہ سے زیادہ 1024 حروف، سے 3D ماڈل بناتا ہے۔ Gen-2.5-Minimum سے Gen-2.5-Extreme-High تک `tier` منتخب کریں (ڈیفالٹ High)، quad یا triangle میں میش سائز، اور PBR یا Shaded جیسا `material` منتخب کریں۔ glb، usdz، fbx، obj یا stl میں برآمد کریں، اور `seed` کو 0 سے 65535 کے درمیان سیٹ کریں۔

پیرامیٹرز

نامقسم ڈیفالٹمجاز تفصیل
promptلازمی
قسمstring
≤ 1,024 کریکٹرز
ماڈل کی تخلیق کی رہنمائی کرنے والی متنی instructions؛ Text-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) میں ہیں۔
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
ضرورت پڑنے پر لاگو کیے جانے والے اضافی options۔
addons.high_packاختیاری
قسمboolean
ڈیفالٹfalse
HighPack enhancement: Quad آؤٹ پٹ میں quality پیرامیٹر کے ذریعے مانگے گئے face count سے تقریباً 16 گنا faces ہوتے ہیں، اور textures ڈیفالٹ 2K کے بجائے 4K ریزولوشن استعمال کرتے ہیں۔
enable_safety_checkerاختیاری
قسمboolean
ڈیفالٹtrue
false سیٹ کر کے اسکریننگ نرم کی جا سکتی ہے، بشرطیکہ کال کرنے والا مجاز ہو۔
لازمی

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-to-3d",
  "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": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/text-to-3d.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt