ਸਮੱਗਰੀ ਵੱਲ ਜਾਓ

Sam 3 1 · Image

ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ

ਮਾਡਲ id sam-3-1/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-1/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.01 10 API ਕ੍ਰੈਡਿਟ ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ
Meta ਚਿੱਤਰ ਸੰਪਾਦਨ #segmentation#mask#real-time

ਟੈਕਸਟ, ਪੁਆਇੰਟ ਜਾਂ ਬਾਕਸ ਪ੍ਰੌਂਪਟਾਂ ਤੋਂ SAM 3.1 ਚਿੱਤਰ ਸੈਗਮੈਂਟੇਸ਼ਨ, ਜੋ ਮਾਸਕ ਚਿੱਤਰ ਵਾਪਸ ਕਰਦੀ ਹੈ

Meta · ਚਿੱਤਰ

ਤੁਹਾਡਾ ਪਹਿਲਾ ਨਤੀਜਾ ਇੱਥੇ ਹੋਵੇਗਾ

ਹੇਠਾਂ ਬੇਨਤੀ ਬਣਾਓ ਅਤੇ ਆਪਣੀ API ਕੁੰਜੀ ਨਾਲ ਚਲਾਓ। ਆਉਟਪੁੱਟ ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਕਾਪੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਹਮੇਸ਼ਾ ਲਈ ਜਾਂ ਮੁਫ਼ਤ ਵਿੱਚ 7 ਦਿਨ ਤੱਕ ਰੱਖੇ ਜਾਂਦੇ ਹਨ।

ਰਿਕਵੈਸਟ ਬਣਾਓ

ਕੰਟਰੋਲ ਮਾਡਲ ਸਕੀਮਾ ਤੋਂ ਤਿਆਰ ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਬਦਲਾਅ ਕਰਦੇ ਹੀ ਕੋਡ ਅਤੇ ਕੀਮਤ ਅੱਪਡੇਟ ਹੋ ਜਾਂਦੇ ਹਨ।

ਡਿਫ਼ਾਲਟ wheel

ਸੈਗਮੈਂਟੇਸ਼ਨ ਨੂੰ ਮਾਰਗਦਰਸ਼ਨ ਦੇਣ ਵਾਲੀ ਟੈਕਸਟ ਹਦਾਇਤ।

•ਲੋੜੀਂਦਾ image_url
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

ਸੈਗਮੈਂਟੇਸ਼ਨ ਲਈ ਚਿੱਤਰ ਵੱਲ ਇਸ਼ਾਰਾ ਕਰਦਾ URL।

ਉੱਨਤ output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format ਡਿਫ਼ਾਲਟ png

ਨਤੀਜੇ ਵਾਲੇ ਚਿੱਤਰ ਦਾ ਫ਼ਾਈਲ ਫਾਰਮੈਟ।

ਡਿਫ਼ਾਲਟ 3

`return_multiple_masks` ਚਾਲੂ ਹੋਣ ’ਤੇ ਵਾਪਸ ਕੀਤੇ ਜਾਣ ਵਾਲੇ ਮਾਸਕਾਂ ਦੀ ਉੱਪਰੀ ਸੀਮਾ।

ਡਿਫ਼ਾਲਟ []

ਬਿੰਦੂ-ਆਧਾਰਿਤ ਪ੍ਰੌਂਪਟਾਂ ਦਾ ਸੰਗ੍ਰਹਿ।

ਡਿਫ਼ਾਲਟ []

ਬਾਕਸ ਪ੍ਰੌਂਪਟ, ਜਿਨ੍ਹਾਂ ਦਾ object_id ਸਮੂਹਬੰਦੀ ਨਿਰਧਾਰਤ ਕਰਦਾ ਹੈ: ਮਿਲਦੀਆਂ IDs ਬਾਕਸਾਂ ਨੂੰ ਇੱਕ ਆਬਜੈਕਟ ਨਾਲ ਜੋੜਦੀਆਂ ਹਨ, ਜਦਕਿ ਖਾਲੀ IDs ਵੱਖਰੇ ਆਬਜੈਕਟ ਦਰਸਾਉਂਦੀਆਂ ਹਨ। ਕਈ ਬਾਕਸ ਦਿੱਤੇ ਜਾ ਸਕਦੇ ਹਨ, ਹਰ ਇੱਕ coordinates (x_min, y_min, x_max, y_max) ਵਰਤਦਾ ਹੈ।

POST /run/sam-3-1/image?wait=20 ਕੋਟ → $0.01
# 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-1/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 ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

Sam 3 1 · Image ਬਾਰੇ

ਟੈਕਸਟ `prompt`, `point_prompts` ਜਾਂ `box_prompts` ਦੀ ਵਰਤੋਂ ਕਰਕੇ SAM 3.1 ਨਾਲ ਇੱਕ ਚਿੱਤਰ ਨੂੰ ਸੈਗਮੈਂਟ ਕਰਦਾ ਹੈ। ਕਈ ਬਾਕਸਾਂ ਨੂੰ object_id ਰਾਹੀਂ ਪ੍ਰਤੀ ਔਬਜੈਕਟ ਸਮੂਹਬੱਧ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। `return_multiple_masks` ਵੱਧ ਤੋਂ ਵੱਧ `max_masks` ਮਾਸਕ (1 ਤੋਂ 32) ਵਾਪਸ ਕਰਦਾ ਹੈ, ਨਾਲ ਵਿਕਲਪਿਕ ਸਕੋਰ ਅਤੇ ਬਾਊਂਡਿੰਗ ਬਾਕਸ। ਆਉਟਪੁੱਟ ਫਾਰਮੈਟ jpeg, png ਜਾਂ webp ਹੈ।

ਪੈਰਾਮੀਟਰ

ਕੈਨੋਨਿਕਲ ਨਾਮ ਜਾਂ ਨੇਟਿਵ ਨਾਮ ਵਿੱਚੋਂ ਕੋਈ ਇੱਕ ਭੇਜੋ, ਦੋਵੇਂ ਨਹੀਂ। ਕੈਨੋਨਿਕਲ ਨਾਮ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
image_urlਲੋੜੀਂਦਾ image
ਕਿਸਮurl · image
ਸੈਗਮੈਂਟੇਸ਼ਨ ਲਈ ਚਿੱਤਰ ਵੱਲ ਇਸ਼ਾਰਾ ਕਰਦਾ URL।
promptਵਿਕਲਪਿਕ
ਕਿਸਮstring
ਡਿਫ਼ਾਲਟwheel
ਸੈਗਮੈਂਟੇਸ਼ਨ ਨੂੰ ਮਾਰਗਦਰਸ਼ਨ ਦੇਣ ਵਾਲੀ ਟੈਕਸਟ ਹਦਾਇਤ।
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-ਕੋਆਰਡੀਨੇਟ।
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
ਇੱਕੋ ਆਬਜੈਕਟ ਨੂੰ ਸੁਧਾਰਨ ਵਾਲੇ ਬਾਕਸਾਂ ਨੂੰ ਸਮੂਹਬੱਧ ਕਰਨ ਵਾਲਾ ਵਿਕਲਪਿਕ ਪਛਾਣਕਰਤਾ।
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
ਉਪਲਬਧ ਹੋਣ ’ਤੇ ਹਰ ਮਾਸਕ ਲਈ ਬਾਊਂਡਿੰਗ ਬਾਕਸ ਸ਼ਾਮਲ ਕਰਨ ਨੂੰ ਨਿਯੰਤਰਿਤ ਕਰਦਾ ਹੈ।
ਲੋੜੀਂਦਾ ਕੈਨੋਨਿਕਲ ਨਾਮ, ਇਹ ਵੀ ਸਵੀਕਾਰਿਆ ਜਾਂਦਾ ਹੈ

ਫ਼ਾਈਲ ਪੈਰਾਮੀਟਰ ਜਨਤਕ https:// URL, 10 MB ਤੱਕ ਦਾ data: URI, ਜਾਂ ਅੱਪਲੋਡ ਦੇ file_url ਨੂੰ ਸਵੀਕਾਰਦੇ ਹਨ। ਫ਼ਾਈਲਾਂ

ਆਉਟਪੁੱਟ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/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": 10,
    "usd": "0.01",
    "charged": 10,
    "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/pa/developers/models/sam-3-1/image.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt