مواد پر جائیں

Segment Anything Model 3

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

ماڈل id sam-3/image
# 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/image?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.005⁩ 5 API کریڈٹس اس صفحے پر چلائیں

API کلید حاصل کریں
Meta تصویر میں ترمیم #segmentation#mask#real-time

متن، پوائنٹ یا باکس پرامپٹ سے تصویر کی سیگمنٹیشن کرتا ہے اور ماسک تصاویر واپس کرتا ہے، اختیاری اسکورز اور باکسز کے ساتھ

Meta · تصویر

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

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

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

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

ڈیفالٹ wheel

سیگمنٹیشن کی رہنمائی کرنے والی متنی ہدایت۔

•لازمی image_url
فائل ڈراپ کریں، یا

سیگمنٹیشن کے لیے تصویر کی طرف اشارہ کرنے والا URL۔

ایڈوانسڈ text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] پسماندہ مطابقت کے لیے برقرار رکھا گیا پرانا ان پٹ؛ اس کی جگہ 'prompt' استعمال کریں۔

output_format ڈیفالٹ png

نتیجہ خیز تصویر کا فائل فارمیٹ۔

ڈیفالٹ 3

`return_multiple_masks` فعال ہونے پر واپس کیے جانے والے ماسکس کی زیادہ سے زیادہ حد۔

ڈیفالٹ []

نقطہ پر مبنی پرامپٹس کا مجموعہ۔

ڈیفالٹ []

باکس پرامپٹس جن کی object_id گروپ بندی متعین کرتی ہے: مماثل IDs باکسز کو ایک آبجیکٹ سے وابستہ کرتے ہیں، جبکہ خالی IDs الگ الگ آبجیکٹس ظاہر کرتے ہیں۔ متعدد باکسز فراہم کیے جا سکتے ہیں، ہر ایک coordinates (x_min, y_min, x_max, y_max) استعمال کرتا ہے۔

POST /run/sam-3/image?wait=20 قیمت → ⁨$0.005⁩
# 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/image?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 کلید حاصل کریں

Segment Anything Model 3 کے بارے میں

متنی `prompt`، `point_prompts` یا `box_prompts` سے SAM 3 کے ذریعے تصویر کو سیگمنٹ کرتا ہے۔ `return_multiple_masks` فعال ہونے پر زیادہ سے زیادہ `max_masks` ماسکس واپس کرتا ہے (1 سے 32)۔ اختیاری اعتماد اسکورز اور باؤنڈنگ باکسز شامل کیے جا سکتے ہیں۔ آؤٹ پٹ فارمیٹ jpeg، png یا webp ہے۔

پیرامیٹرز

معیاری نام یا مقامی نام میں سے صرف ایک بھیجیں، دونوں نہیں۔ معیاری نام

نامقسم ڈیفالٹمجاز تفصیل
image_urlلازمی image
قسمurl · image
سیگمنٹیشن کے لیے تصویر کی طرف اشارہ کرنے والا URL۔
promptاختیاری
قسمstring
ڈیفالٹwheel
سیگمنٹیشن کی رہنمائی کرنے والی متنی ہدایت۔
text_promptاختیاری
قسمstring | null
[DEPRECATED] پسماندہ مطابقت کے لیے برقرار رکھا گیا پرانا ان پٹ؛ اس کی جگہ 'prompt' استعمال کریں۔
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
ایک آبجیکٹ کو بہتر بنانے والے پرامپٹس کو گروپ کرنے کے لیے اختیاری شناخت کنندہ۔ اگر متن بھی پرامپٹ کے طور پر فراہم کیا جائے تو یہ شناخت کنندہ طے کرتا ہے کہ دریافت شدہ کون سا آبجیکٹ ان نقاط سے بہتر کیا جائے۔
point_prompts[].frame_indexاختیاری
قسمinteger | null
تعامل کے لیے فریم کی شناخت کرنے والا انڈیکس۔
box_promptsاختیاری
قسمobject[]
ڈیفالٹ[]
باکس پرامپٹس جن کی object_id گروپ بندی متعین کرتی ہے: مماثل IDs باکسز کو ایک آبجیکٹ سے وابستہ کرتے ہیں، جبکہ خالی IDs الگ الگ آبجیکٹس ظاہر کرتے ہیں۔ متعدد باکسز فراہم کیے جا سکتے ہیں، ہر ایک coordinates (x_min, y_min, x_max, y_max) استعمال کرتا ہے۔
box_prompts[].x_minاختیاری
قسمinteger | null
باکس کے لیے کم از کم x-coordinate۔
box_prompts[].y_minاختیاری
قسمinteger | null
باکس کے لیے کم از کم y-coordinate۔
box_prompts[].x_maxاختیاری
قسمinteger | null
باکس کے لیے زیادہ سے زیادہ X coordinate۔
box_prompts[].y_maxاختیاری
قسمinteger | null
باکس کے لیے زیادہ سے زیادہ Y coordinate۔
box_prompts[].object_idاختیاری
قسمinteger | null
ایک آبجیکٹ کو بہتر بنانے والے باکسز کو گروپ کرنے کے لیے اختیاری شناخت کنندہ۔
box_prompts[].frame_indexاختیاری
قسمinteger | null
تعامل کے لیے فریم کی شناخت کرنے والا انڈیکس۔
apply_maskاختیاری
قسمboolean
ڈیفالٹtrue
کنٹرول کرتا ہے کہ تصویر پر ماسک لاگو کیا جائے یا نہیں۔
output_formatاختیاری
قسمenum
ڈیفالٹpng
jpegpngwebp
نتیجہ خیز تصویر کا فائل فارمیٹ۔
return_multiple_masksاختیاری
قسمboolean
ڈیفالٹfalse
متعدد ماسک واپس کرنے کا اختیار: اسے فعال کرنے پر `max_masks` طے کرتا ہے کہ کتنے تخلیق کردہ ماسک اپ لوڈ کر کے جواب میں شامل کیے جائیں۔
max_masksاختیاری
قسمinteger
ڈیفالٹ3
1 – 32
`return_multiple_masks` فعال ہونے پر واپس کیے جانے والے ماسکس کی زیادہ سے زیادہ حد۔
include_scoresاختیاری
قسمboolean
ڈیفالٹfalse
ماسکس کے لیے اعتماد کے اسکور شامل کرنے کو کنٹرول کرتا ہے۔
include_boxesاختیاری
قسمboolean
ڈیفالٹfalse
دستیاب ہونے کی صورت میں ہر ماسک کے لیے bounding box شامل کرنے کو کنٹرول کرتا ہے۔
لازمی معیاری نام، یہ بھی قبول ہے

فائل پیرامیٹرز عوامی https:// URL، 10 MB تک کی data: URI، یا اپ لوڈ کے file_url کو قبول کرتے ہیں۔ فائلیں

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/image",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
    },
    "masks": [
      {
        "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
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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 ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
image
object {url, content_type, file_name, file_size, width, height} | nullبنیادی سیگمنٹیشن ماسک دکھانے والا پیش نظارہ۔
masks
array of object {url, content_type, file_name, file_size, width, height}سیگمنٹیشن ماسکس پر مشتمل تصاویر۔
metadata
array of object {index, score, box} | nullہر ماسک کے لیے میٹا ڈیٹا، جس میں اس کا اسکور اور باکس شامل ہیں۔
scores
array of number | nullہر ماسک کا اعتماد اسکور، درخواست کیے جانے پر فراہم کیا جاتا ہے۔
boxes
array of array of number | nullہر ماسک کے لیے نارملائزڈ باکس، درخواست کیے جانے پر [cx, cy, w, h] کے طور پر ظاہر کیے جاتے ہیں۔

مزید ماڈلز: تصویر میں ترمیم

AI ایجنٹس کے لیے: یہ صفحہ Markdown میں یہاں موجود ہے https://doitong.com/ur/developers/models/sam-3/image.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt