رفتن به محتوا

Sam 3 · 3D Objects

یکپارچه‌سازی

شناسه مدل sam-3/3d-objects
# 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/sam-3/3d-objects?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

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

دریافت کلید API
Meta تصویر به 3D #3d#object

اشیای سه‌بعدی را از تصویر بازسازی می‌کند؛ اشیا با اعلان‌های متنی، نقطه‌ای یا کادری یا ماسک‌ها انتخاب می‌شوند و خروجی splat ارائه می‌شود

Meta · 3D

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

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

ساخت درخواست

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

پیش‌فرض car

متن مورد استفاده برای بخش‌بندی خودکار در صورت نبود ماسک، مانند 'chair' یا 'lamp'.

•الزامی image_url
یک فایل بیندازید، یا

URL تصویر برای بازسازی سه‌بعدی.

پیشرفته mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
یک فایل بیندازید، یا

فهرست اختیاری URL ماسک برای هر شیء. بدون ماسک، بخش‌بندی خودکار در صورت ارائه از پرامپت، point_prompts یا box_prompts استفاده می‌کند؛ اگر هیچ ماسک یا پرامپت بخش‌بندی ارائه نشود، کل تصویر استفاده می‌شود.

URL اختیاری برای بهبود برآورد عمق در بازسازی سه‌بعدی با ارائهٔ دادهٔ خارجی pointmap یا عمق به‌صورت NPY یا NPZ.

آستانهٔ اطمینان تشخیص که در صورت حذف، به مقدار پیش‌فرض مدل واگذار می‌شود. مقادیر از 0.1 تا 1.0 هستند؛ مقادیر کمتر، دقت را با افزایش تعداد تشخیص‌ها مبادله می‌کنند.

seed استفاده‌شده برای تولید تصادفی تکرارپذیر.

پیش‌فرض []

پرامپت‌های مبتنی بر نقطه برای بخش‌بندی خودکار در صورت نبود ماسک.

پیش‌فرض []

پرامپت‌های کادر که از طریق بخش‌بندی خودکار، ماسک‌های جداگانهٔ اشیا را برای بازسازی سه‌بعدی تولید می‌کنند و فقط در صورت نبود ماسک استفاده می‌شوند. می‌توان چند کادر ارسال کرد.

POST /run/sam-3/3d-objects?wait=20 قیمت → ⁨‎$۰٫۰۲⁩
# 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/sam-3/3d-objects?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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

درباره Sam 3 · 3D Objects

اشیای موجود در عکس را به دارایی‌های سه‌بعدی تبدیل می‌کند. اشیا را با `mask_urls`، یک `prompt` متنی، `point_prompts` یا `box_prompts` انتخاب کنید؛ چند کادر، اشیای جداگانه تولید می‌کنند. `detection_threshold` مقادیر 0.1 تا 1 را می‌پذیرد و `export_textured_glb` بافت و UVها را اعمال می‌کند. خروجی‌ها شامل یک GLB، فایل‌های Gaussian splat، فایل‌های جداگانه برای هر شیء در صحنه‌های چندشیئی، فراداده و یک بسته zip هستند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL تصویر برای بازسازی سه‌بعدی.
mask_urlsاختیاری
نوعurl[] · image
فهرست اختیاری URL ماسک برای هر شیء. بدون ماسک، بخش‌بندی خودکار در صورت ارائه از پرامپت، point_prompts یا box_prompts استفاده می‌کند؛ اگر هیچ ماسک یا پرامپت بخش‌بندی ارائه نشود، کل تصویر استفاده می‌شود.
promptاختیاری
نوعstring | null
پیش‌فرضcar
متن مورد استفاده برای بخش‌بندی خودکار در صورت نبود ماسک، مانند 'chair' یا 'lamp'.
point_promptsاختیاری
نوعobject[]
پیش‌فرض[]
پرامپت‌های مبتنی بر نقطه برای بخش‌بندی خودکار در صورت نبود ماسک.
point_prompts[].xاختیاری
نوعinteger | null
موقعیت پرامپت روی محور X.
point_prompts[].yاختیاری
نوعinteger | null
موقعیت پرامپت روی محور Y.
point_prompts[].labelاختیاری
نوعenum
01
برچسب پیش‌زمینه/پس‌زمینه: مقدار 1 نشان‌دهنده پیش‌زمینه و 0 نشان‌دهنده پس‌زمینه است.
point_prompts[].object_idاختیاری
نوعinteger | null
شناسه اختیاری برای گروه‌بندی پرامپت‌هایی که یک شیء را اصلاح می‌کنند. اگر متن نیز به‌عنوان پرامپت ارائه شود، این شناسه تعیین می‌کند نقاط کدام شیء شناسایی‌شده را اصلاح کنند.
box_promptsاختیاری
نوعobject[]
پیش‌فرض[]
پرامپت‌های کادر که از طریق بخش‌بندی خودکار، ماسک‌های جداگانهٔ اشیا را برای بازسازی سه‌بعدی تولید می‌کنند و فقط در صورت نبود ماسک استفاده می‌شوند. می‌توان چند کادر ارسال کرد.
box_prompts[].x_minاختیاری
نوعinteger | null
کمینهٔ مختصات x برای کادر.
box_prompts[].y_minاختیاری
نوعinteger | null
کمینهٔ مختصات y برای کادر.
box_prompts[].x_maxاختیاری
نوعinteger | null
حداکثر مختصات X برای جعبه.
box_prompts[].y_maxاختیاری
نوعinteger | null
حداکثر مختصات Y برای جعبه.
box_prompts[].object_idاختیاری
نوعinteger | null
شناسه اختیاری برای گروه‌بندی جعبه‌هایی که یک شیء را اصلاح می‌کنند.
seedاختیاری
نوعinteger | null
seed استفاده‌شده برای تولید تصادفی تکرارپذیر.
pointmap_urlاختیاری
نوعstring | null
URL اختیاری برای بهبود برآورد عمق در بازسازی سه‌بعدی با ارائهٔ دادهٔ خارجی pointmap یا عمق به‌صورت NPY یا NPZ.
detection_thresholdاختیاری
نوعnumber | null
۰٫۱ – ۱
آستانهٔ اطمینان تشخیص که در صورت حذف، به مقدار پیش‌فرض مدل واگذار می‌شود. مقادیر از 0.1 تا 1.0 هستند؛ مقادیر کمتر، دقت را با افزایش تعداد تشخیص‌ها مبادله می‌کنند.
export_textured_glbاختیاری
نوعboolean
پیش‌فرضfalse
گزینهٔ صادرات GLB: فعال‌سازی این گزینه رنگ‌های رأس را با بافت پخته و UVها جایگزین می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/3d-objects",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "gaussian_splat": {
      "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_glb": {
      "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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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
    }
  },
  "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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
gaussian_splat
object {url, content_type, file_name, file_size}splat صحنهٔ ترکیبی برای نتایج چندشیئی، یا در غیر این صورت یک splat منفرد؛ به‌صورت فایل Gaussian splat در قالب .ply ارائه می‌شود.
model_glb
object {url, content_type, file_name, file_size}خروجی سه‌بعدی ذخیره‌شده به‌صورت GLB: چند شیء در یک صحنه مونتاژ می‌شوند، در حالی که سایر نتایج شامل یک مش هستند.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}فرادادهٔ هر شیء، شامل چرخش، انتقال و مقیاس.
individual_splats
array of object {url, content_type, file_name, file_size} | nullفایل‌های Gaussian splat جداگانه برای هر شیء که فقط در صحنه‌های چندشیئی در دسترس هستند.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullفایل‌های مش GLB جداگانه برای هر شیء که فقط در صحنه‌های چندشیئی در دسترس هستند.
artifacts_zip
object {url, content_type, file_name, file_size} | nullبایگانی ZIP شامل همهٔ مصنوعات و فراداده.

مدل‌های بیشتر: تصویر به 3D

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/sam-3/3d-objects.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt