सामग्री पर जाएँ

Sam 3 · 3D Objects

इंटीग्रेट करें

मॉडल id 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"

यह अनुरोध: ≈$0.02 20 API क्रेडिट इसे इस पेज पर चलाएँ

API कुंजी प्राप्त करें
Meta इमेज से 3D #3d#object

टेक्स्ट, पॉइंट या बॉक्स प्रॉम्प्ट अथवा मास्क से चुने गए ऑब्जेक्ट का छवि से 3D पुनर्निर्माण, जिसमें splat आउटपुट मिलता है

Meta · 3D

आपका पहला परिणाम यहाँ आएगा

नीचे एक अनुरोध बनाएँ और उसे अपनी API कुंजी से चलाएँ। आउटपुट हमारे स्टोरेज में कॉपी किए जाते हैं और हमेशा के लिए या 7 दिन तक मुफ़्त में रखे जाते हैं।

अनुरोध बनाएँ

कंट्रोल मॉडल स्कीमा से जनरेट होते हैं। इन्हें बदलने पर कोड और कीमत अपडेट होती है।

डिफ़ॉल्ट car

मास्क न होने पर ऑटोमैटिक सेगमेंटेशन के लिए इस्तेमाल किया जाने वाला टेक्स्ट, जैसे 'chair' या 'lamp'।

•आवश्यक image_url
फ़ाइल ड्रॉप करें, या

3D पुनर्निर्माण के लिए इमेज का URL।

उन्नत mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
फ़ाइल ड्रॉप करें, या

हर ऑब्जेक्ट के लिए मास्क URL की वैकल्पिक सूची। मास्क न होने पर, ऑटोमैटिक सेगमेंटेशन दिए गए प्रॉम्प्ट, point_prompts या box_prompts का उपयोग करता है; यदि न मास्क दिए गए हों और न सेगमेंटेशन प्रॉम्प्ट, तो पूरी इमेज का उपयोग होता है।

NPY या NPZ के रूप में बाहरी pointmap या डेप्थ डेटा देकर 3D पुनर्निर्माण में गहराई के अनुमान को बेहतर बनाने के लिए वैकल्पिक URL।

पहचान के कॉन्फ़िडेंस की न्यूनतम सीमा; इसे न देने पर मॉडल का डिफ़ॉल्ट उपयोग होता है। मान 0.1 से 1.0 तक हो सकते हैं; छोटे मान पहचान की संख्या बढ़ाते हैं, लेकिन सटीकता घटाते हैं।

पुनरुत्पाद्य रैंडम निर्माण के लिए उपयोग किया गया सीड।

डिफ़ॉल्ट []

मास्क न होने पर ऑटोमैटिक सेगमेंटेशन के लिए इस्तेमाल किए जाने वाले बिंदु-आधारित प्रॉम्प्ट।

डिफ़ॉल्ट []

बॉक्स प्रॉम्प्ट जो ऑटोमैटिक सेगमेंटेशन के ज़रिए 3D पुनर्निर्माण के लिए अलग-अलग ऑब्जेक्ट मास्क बनाते हैं। इनका उपयोग केवल तब होता है जब कोई मास्क नहीं दिया गया हो। कई बॉक्स भेजे जा सकते हैं।

POST /run/sam-3/3d-objects?wait=20 कोटेशन → $0.02
# 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"

यह अनुरोध चलाएँ

आपकी key इसी ब्राउज़र में रहती है: इसे केवल Doitong API को भेजा जाता है और केवल तभी (localStorage) में सेव किया जाता है जब आप Remember चुनते हैं। API कुंजी प्राप्त करें

Sam 3 · 3D Objects के बारे में

फ़ोटो में मौजूद ऑब्जेक्ट को 3D एसेट में बदलता है। `mask_urls`, टेक्स्ट `prompt`, `point_prompts` या `box_prompts` से ऑब्जेक्ट चुनें; कई बॉक्स अलग-अलग ऑब्जेक्ट देते हैं। `detection_threshold` 0.1 से 1 स्वीकार करता है, और `export_textured_glb` टेक्सचर तथा UVs को बेक करता है। GLB, Gaussian splat फ़ाइलें, मल्टी-ऑब्जेक्ट दृश्यों के लिए प्रति-ऑब्जेक्ट फ़ाइलें, मेटाडेटा और zip बंडल आउटपुट करता है।

पैरामीटर

कैनोनिकल नाम या नेटिव नाम में से कोई एक भेजें, दोनों नहीं। कैनोनिकल नाम

नामप्रकार डिफ़ॉल्टअनुमत विवरण
image_urlआवश्यक image
प्रकारurl · image
3D पुनर्निर्माण के लिए इमेज का 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[]
डिफ़ॉल्ट[]
बॉक्स प्रॉम्प्ट जो ऑटोमैटिक सेगमेंटेशन के ज़रिए 3D पुनर्निर्माण के लिए अलग-अलग ऑब्जेक्ट मास्क बनाते हैं। इनका उपयोग केवल तब होता है जब कोई मास्क नहीं दिया गया हो। कई बॉक्स भेजे जा सकते हैं।
box_prompts[].x_minवैकल्पिक
प्रकारinteger | null
बॉक्स के लिए न्यूनतम x-coordinate।
box_prompts[].y_minवैकल्पिक
प्रकारinteger | null
बॉक्स के लिए न्यूनतम y-coordinate।
box_prompts[].x_maxवैकल्पिक
प्रकारinteger | null
बॉक्स का अधिकतम X कोऑर्डिनेट।
box_prompts[].y_maxवैकल्पिक
प्रकारinteger | null
बॉक्स का अधिकतम Y कोऑर्डिनेट।
box_prompts[].object_idवैकल्पिक
प्रकारinteger | null
एक ऑब्जेक्ट को परिष्कृत करने वाले बॉक्स को समूहित करने वाला वैकल्पिक पहचानकर्ता।
seedवैकल्पिक
प्रकारinteger | null
पुनरुत्पाद्य रैंडम निर्माण के लिए उपयोग किया गया सीड।
pointmap_urlवैकल्पिक
प्रकारstring | null
NPY या NPZ के रूप में बाहरी pointmap या डेप्थ डेटा देकर 3D पुनर्निर्माण में गहराई के अनुमान को बेहतर बनाने के लिए वैकल्पिक URL।
detection_thresholdवैकल्पिक
प्रकारnumber | null
0.1 – 1
पहचान के कॉन्फ़िडेंस की न्यूनतम सीमा; इसे न देने पर मॉडल का डिफ़ॉल्ट उपयोग होता है। मान 0.1 से 1.0 तक हो सकते हैं; छोटे मान पहचान की संख्या बढ़ाते हैं, लेकिन सटीकता घटाते हैं।
export_textured_glbवैकल्पिक
प्रकारboolean
डिफ़ॉल्टfalse
GLB एक्सपोर्ट का विकल्प: इसे सक्षम करने पर वर्टेक्स रंगों की जगह बेक किया गया टेक्सचर और UVs इस्तेमाल होते हैं।
आवश्यक कैनोनिकल नाम, यह भी स्वीकार्य है

फ़ाइल पैरामीटर में सार्वजनिक https:// URL, 10 MB तक का data: URI, या अपलोड का 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-माह भुगतान) या 7 दिन तक मुफ़्त में, आपके अकाउंट की सेटिंग या ?storage= के अनुसार।
हर मॉडल पर एक जैसा आकारइमेज, वीडियो और ऑडियो सभी के लिए type, url, content_type, width, height और duration। output मॉडल का अपना परिणाम ऑब्जेक्ट है।
आउटपुट के फ़ील्ड
gaussian_splat
object {url, content_type, file_name, file_size}कई ऑब्जेक्ट वाले परिणामों के लिए संयुक्त सीन स्प्लैट, अन्यथा एक स्प्लैट; .ply फ़ॉर्मैट में गॉसियन स्प्लैट फ़ाइल के रूप में दिया जाता है।
model_glb
object {url, content_type, file_name, file_size}GLB के रूप में सहेजा गया 3D आउटपुट: कई ऑब्जेक्ट को एक सीन में जोड़ा जाता है, जबकि अन्य परिणामों में एक मेश होता है।
metadata
array of object {object_index, scale, rotation, translation, camera_pose}प्रत्येक ऑब्जेक्ट का मेटाडेटा, जिसमें रोटेशन, ट्रांसलेशन और स्केल शामिल हैं।
individual_splats
array of object {url, content_type, file_name, file_size} | nullप्रत्येक ऑब्जेक्ट के लिए अलग गॉसियन स्प्लैट फ़ाइलें, जो केवल कई ऑब्जेक्ट वाले सीन में उपलब्ध हैं।
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

AI एजेंट के लिए: इस पेज का Markdown यहाँ है https://doitong.com/hi/developers/models/sam-3/3d-objects.md. सभी मॉडल और गाइड: https://doitong.com/developers/llms.txt