কনটেন্টে যান

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"

এই অনুরোধ: ≈০.০২$ ২০ API ক্রেডিট এই পেজে চালান

API কী পান
Meta ছবি থেকে 3D #3d#object

টেক্সট, পয়েন্ট বা বক্স প্রম্পট অথবা মাস্ক দিয়ে নির্বাচিত ছবির অবজেক্ট থেকে splat আউটপুটসহ 3D অবজেক্ট পুনর্গঠন করে

Meta · 3D

আপনার প্রথম ফলাফল এখানে আসবে

নিচে একটি রিকোয়েস্ট তৈরি করে আপনার API কী দিয়ে চালান। আউটপুট আমাদের স্টোরেজে কপি করা হয়, চিরকাল বা বিনামূল্যে ৭ দিন পর্যন্ত রাখা হয়।

একটি অনুরোধ তৈরি করুন

মডেল স্কিমা থেকে কন্ট্রোল তৈরি করা হয়। এগুলো পরিবর্তন করলে কোড ও মূল্য আপডেট হয়।

ডিফল্ট car

mask না থাকলে automatic segmentation-এর জন্য ব্যবহৃত টেক্সট, যেমন 'chair' বা 'lamp'।

•আবশ্যক image_url
একটি ফাইল ড্রপ করুন, অথবা

3D reconstruction-এর জন্য ছবির URL।

অ্যাডভান্সড mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
একটি ফাইল ড্রপ করুন, অথবা

ঐচ্ছিক per-object mask URL-এর তালিকা। mask না থাকলে, দেওয়া থাকলে automatic segmentation-এর জন্য প্রম্পট, point_prompts বা box_prompts ব্যবহার করা হয়; mask বা segmentation প্রম্পট—কোনোটিই না দিলে পুরো ছবি ব্যবহার করা হয়।

NPY বা NPZ হিসেবে external pointmap বা depth data দিয়ে 3D reconstruction-এ depth estimation উন্নত করার ঐচ্ছিক URL।

Detection confidence cutoff; না দিলে মডেলের ডিফল্ট ব্যবহার করা হয়। মান 0.1 থেকে 1.0 পর্যন্ত হতে পারে; কম মানে precision কমে, তবে শনাক্তকরণের সংখ্যা বাড়ে।

পুনরুৎপাদনযোগ্য র‍্যান্ডম জেনারেশনের জন্য ব্যবহৃত Seed।

ডিফল্ট []

mask না থাকলে automatic segmentation-এর জন্য ব্যবহৃত point-based প্রম্পট।

ডিফল্ট []

automatic segmentation-এর মাধ্যমে 3D reconstruction-এর জন্য পৃথক object mask তৈরি করা box প্রম্পট; mask দেওয়া না থাকলেই শুধু ব্যবহার করা হয়। একাধিক box পাঠানো যায়।

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"

এই অনুরোধ চালান

আপনার key এই ব্রাউজারেই থাকে: এটি শুধু Doitong API-তে পাঠানো হয় এবং Remember টিক দিলে কেবল localStorage-এ সংরক্ষিত হয়। একটি API কী পান

Sam 3 · 3D Objects সম্পর্কে

ছবির অবজেক্টকে 3D অ্যাসেটে রূপান্তর করে। `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
3D reconstruction-এর জন্য ছবির URL।
mask_urlsঐচ্ছিক
ধরনurl[] · image
ঐচ্ছিক per-object mask URL-এর তালিকা। mask না থাকলে, দেওয়া থাকলে automatic segmentation-এর জন্য প্রম্পট, point_prompts বা box_prompts ব্যবহার করা হয়; mask বা segmentation প্রম্পট—কোনোটিই না দিলে পুরো ছবি ব্যবহার করা হয়।
promptঐচ্ছিক
ধরনstring | null
ডিফল্টcar
mask না থাকলে automatic segmentation-এর জন্য ব্যবহৃত টেক্সট, যেমন 'chair' বা 'lamp'।
point_promptsঐচ্ছিক
ধরনobject[]
ডিফল্ট[]
mask না থাকলে automatic segmentation-এর জন্য ব্যবহৃত point-based প্রম্পট।
point_prompts[].xঐচ্ছিক
ধরনinteger | null
X অক্ষ বরাবর প্রম্পটের অবস্থান।
point_prompts[].yঐচ্ছিক
ধরনinteger | null
Y অক্ষ বরাবর প্রম্পটের অবস্থান।
point_prompts[].labelঐচ্ছিক
ধরনenum
01
Foreground/background লেবেল: 1 foreground নির্দেশ করে; 0 background নির্দেশ করে।
point_prompts[].object_idঐচ্ছিক
ধরনinteger | null
একটি অবজেক্ট পরিশোধনকারী প্রম্পটগুলোকে গোষ্ঠীবদ্ধ করার ঐচ্ছিক শনাক্তকারী। প্রম্পট হিসেবে টেক্সটও দেওয়া হলে, শনাক্তকারীটি নির্ধারণ করে কোন শনাক্ত করা অবজেক্টকে ওই পয়েন্টগুলো পরিশোধন করবে।
box_promptsঐচ্ছিক
ধরনobject[]
ডিফল্ট[]
automatic segmentation-এর মাধ্যমে 3D reconstruction-এর জন্য পৃথক object mask তৈরি করা box প্রম্পট; mask দেওয়া না থাকলেই শুধু ব্যবহার করা হয়। একাধিক box পাঠানো যায়।
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
NPY বা NPZ হিসেবে external pointmap বা depth data দিয়ে 3D reconstruction-এ depth estimation উন্নত করার ঐচ্ছিক URL।
detection_thresholdঐচ্ছিক
ধরনnumber | null
০.১ – ১
Detection confidence cutoff; না দিলে মডেলের ডিফল্ট ব্যবহার করা হয়। মান 0.1 থেকে 1.0 পর্যন্ত হতে পারে; কম মানে precision কমে, তবে শনাক্তকরণের সংখ্যা বাড়ে।
export_textured_glbঐচ্ছিক
ধরনboolean
ডিফল্টfalse
GLB export-এর বিকল্প: এটি সক্রিয় করলে vertex colors-এর বদলে baked texture ও 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-মাস অনুযায়ী অর্থপ্রদত্ত) অথবা অ্যাকাউন্ট সেটিংস বা ?storage= অনুযায়ী বিনামূল্যে ৭ দিন পর্যন্ত।
প্রতিটি মডেলে একই গঠনছবি, ভিডিও এবং অডিও—সব ক্ষেত্রেই type, url, content_type, width, height এবং duration। output হলো মডেলের নিজস্ব ফলাফল অবজেক্ট।
আউটপুটের ফিল্ড
gaussian_splat
object {url, content_type, file_name, file_size}একাধিক object-এর ফলাফলের জন্য combined scene splat, অন্যথায় একটি single splat; .ply ফরম্যাটের Gaussian splat ফাইল হিসেবে দেওয়া হয়।
model_glb
object {url, content_type, file_name, file_size}GLB হিসেবে সংরক্ষিত 3D আউটপুট: একাধিক object একটি scene-এ একত্র করা হয়, আর অন্যান্য ফলাফলে একটি mesh থাকে।
metadata
array of object {object_index, scale, rotation, translation, camera_pose}প্রতিটি object-এর metadata, যাতে rotation, translation ও scale অন্তর্ভুক্ত থাকে।
individual_splats
array of object {url, content_type, file_name, file_size} | nullপ্রতিটি object-এর জন্য আলাদা Gaussian splat ফাইল, শুধু একাধিক object থাকা scene-এ পাওয়া যায়।
individual_glbs
array of object {url, content_type, file_name, file_size} | nullপ্রতিটি object-এর জন্য আলাদা GLB mesh ফাইল, শুধু একাধিক object থাকা scene-এ পাওয়া যায়।
artifacts_zip
object {url, content_type, file_name, file_size} | nullসব artifact ও metadata-সহ ZIP archive।

আরও মডেল: ছবি থেকে 3D

AI এজেন্টদের জন্য: এই পৃষ্ঠাটি Markdown হিসেবে এখানে আছে https://doitong.com/bn/developers/models/sam-3/3d-objects.md. সব মডেল ও গাইড: https://doitong.com/developers/llms.txt