مواد پر جائیں

Sam 3 · Image RLE

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

ماڈل id sam-3/image-rle
# 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/sam-3/image-rle?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست: ≈⁨$0.005⁩ 5 API کریڈٹس · ≈ ⁨₽0.53⁩ اس صفحے پر چلائیں

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

تصویر کی سیگمنٹیشن کرتا ہے اور ماسک کو تصویر کے بجائے رن لینتھ انکوڈ شدہ ڈیٹا کے طور پر واپس کرتا ہے

Meta · ڈیٹا (JSON)

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

ذیل میں درخواست بنائیں اور اپنی 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-rle?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.ru/v1/run/sam-3/image-rle?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست چلائیں

آپ کی key اسی براؤزر میں رہتی ہے: یہ صرف Doitong API کو بھیجی جاتی ہے اور صرف اس صورت میں localStorage میں محفوظ ہوتی ہے جب آپ Remember منتخب کریں۔ API کلید حاصل کریں

Sam 3 · Image RLE کے بارے میں

متنی `prompt`، پوائنٹس یا باکسز کے ذریعے تصویر پر SAM 3 سیگمنٹیشن چلاتا ہے اور ماسک کو رن لینتھ انکوڈنگ (RLE) ڈیٹا کے طور پر واپس کرتا ہے۔ پوسٹ پروسیسنگ کے لیے مختصر ماسک ڈیٹا درکار ہو تو مفید ہے۔ `return_multiple_masks` کو `max_masks` کے ساتھ 1 سے 32 تک سپورٹ کرتا ہے، نیز اختیاری اسکورز اور باکسز بھی۔

پیرامیٹرز

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

نامقسم ڈیفالٹمجاز تفصیل
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-rle",
  "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": {
    "rle": "string",
    "boundingbox_frames_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
    },
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "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-ماہ ادائیگی) یا مفت میں 7 دن تک، آپ کی اکاؤنٹ سیٹنگ یا ?storage= کے مطابق۔
ہر ماڈل میں ایک جیسی ساختtype، url، content_type، width، height اور duration، تصاویر، ویڈیو اور آڈیو سب کے لیے یکساں۔ output ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
rle
string | array of stringرن-لینتھ انکوڈنگ کے ذریعے ظاہر کیا گیا ماسک۔
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullہر فریم کے باؤنڈنگ باکس اوورلے کا ZIP آرکائیو۔
metadata
array of object {index, score, box} | nullہر ماسک کا میٹا ڈیٹا، جب جواب میں متعدد RLE شامل ہوں۔
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-rle.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt