رفتن به محتوا

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۴۰⁩ ۴۰۰ اعتبار API · ≈ ⁨‎₽۴۲٫۱۹⁩ اجرای آن در این صفحه

دریافت کلید API
Hyper3D تصویر به 3D خروجی 4Kسریع #image-to-3d#text-to-3d

تبدیل متن یا تصویر به 3D با Rodin v2، با حداکثر 5 تصویر ورودی، presetهای مش چهارضلعی یا مثلثی و رندر پیش‌نمایش

Hyper3D · 3D

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

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 مدل‌های high-poly ارائه می‌دهد و وضوح بافت را از 1K پیش‌فرض به 4K ارتقا می‌دهد.

سید تصادفی اختیاری در بازه 0–65535.

اندازه جعبه محدودکننده به‌صورت آرایه مرتب‌شده [width, height, length].

POST /run/hyper3d/rodin/v2?wait=20 قیمت → ⁨‎$۰٫۴۰⁩
# 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?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

از پرامپت حداکثر 1024 نویسه و حداکثر 5 تصویر در `input_image_urls` مدل‌های 3D می‌سازد. `quality_mesh_option` مش‌های چهارضلعی از 4K تا 50K و مش‌های مثلثی از 2K تا 500K ارائه می‌دهد. از `material` برابر PBR، Shaded یا All، و همچنین `TAPose`، `use_original_alpha` و `preview_render` پشتیبانی می‌کند.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
promptاختیاری
نوعstring
پیش‌فرض
≤ ۱٬۰۲۴ نویسه
تولید را با پرامپت متنی هدایت کنید، یا در حالت Image-to-3D آن را خالی بگذارید تا هوش مصنوعی پرامپت را از تصاویر شما استخراج کند.
input_image_urlsاختیاری
نوعurl[] · image
URLهای تصاویر منبع، محدود به 5 تصویر و در حالت Image-to-3D الزامی، برای تولید مدل.
use_original_alphaاختیاری
نوعboolean
پیش‌فرضfalse
حفظ کانال‌های شفافیت تصویر ورودی هنگام تولید محتوای سه‌بعدی را کنترل می‌کند.
seedاختیاری
نوعinteger | null
۰ – ۶۵٬۵۳۵
سید تصادفی اختیاری در بازه 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 مدل‌های high-poly ارائه می‌دهد و وضوح بافت را از 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?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
integerSeed اعمال‌شده هنگام تولید.
textures
array of object {url, content_type, file_name, file_size, width, height}بافت‌های تولیدشده برای شیء سه‌بعدی.

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/hyper3d/rodin/v2.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt