שפּרינגען צו אינהאַלט

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 רעפּרעזענטירן באַזונדערע אָביעקטן. מע קען צושטעלן קייפל קעסטלעך, יעדעס מיט קאָאָרדינאַטן (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) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Segment Anything Model 3

סעגמענטירט אַ בילד מיט SAM 3 פֿון אַ טעקסט־`prompt`, `point_prompts` אָדער `box_prompts`. ווען `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 רעפּרעזענטירן באַזונדערע אָביעקטן. מע קען צושטעלן קייפל קעסטלעך, יעדעס מיט קאָאָרדינאַטן (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, אַ data: URI ביז 10 MB, אָדער דעם 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/yi/developers/models/sam-3/image.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt