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

Sam 3 1 · Video RLE

אינטעגרירן

מאָדעל־id sam-3-1/video-rle
# 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/video-rle?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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.19⁩ 190 API־קרעדיטן אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Meta ווידעא צו ווידעא #segmentation#mask#real-time

SAM 3.1 ווידעאָ־סעגמענטאַציע מיט RLE־מאַסקס, מאַסקע־סידינג און אָפּציאָנעלע מאַסקס פֿאַר יעדן אָבדזשעקט אין יעדן פֿריים

Meta · ווידעא

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

סטאַנדאַרט

סעגמענטאַציע־פּראָמפּט וואָס שטיצט עטלעכע נאָכגעפֿאָלגטע אָביעקטן דורך באַשרײַבונגען צעטיילט מיט קאָמעס, למשל 'person, cloth'.

•פארלאנגט video_url
לייגט אַרײַן אַ טעקע, אָדער

ווידעא־URL פֿאַר סעגמענטאַציע.

פֿאָרגעשריטן mask · detection_threshold · frame_index · max_num_objects · apply_mask · boundingbox_zip · return_object_rles · point_prompts · box_prompts
mask_url
לייגט אַרײַן אַ טעקע, אָדער

מאַסקע־URL פֿאַר דער ערשטער אָנווענדונג.

סטאַנדאַרט 0.5

שוועל פֿאַר דער דערקענונגס־צוטרוי מיט סטאַנדאַרטן פֿון 0.5 פֿאַר עקזיסטירנדיקע אָביעקטן און 0.7 פֿאַר נײַע. אינעם גרענעץ פֿון 0.0–1.0 געבן קלענערע ווערטן מער דערקענונגען אויפֿן חשבון פֿון פּינקטלעכקייט; פּרוּווט 0.2–0.3 ווען טעקסט־פּראָמפּטן אַרבעטן נישט.

סטאַנדאַרט 0

אינדעקס פֿונעם ראַם פֿאַר דער ערשטער אינטעראַקציע ווען mask_url ווערט צוגעשטעלט.

סטאַנדאַרט 16

מאַקסימאַלע צאָל אָביעקטן וואָס ווערן נאָכגעפֿאָלגט אינעם ווידעא.

סטאַנדאַרט []

רשימה פֿון פּונקט־פּראָמפּטן וואָס באַשטימען ראַם־אינדעקסן.

סטאַנדאַרט []

רשימה פֿון קעסטל־פּראָמפּטן, מיט אַן אָפּציאָנעלן frame_index פֿאַר יעדער פּאָזיציע.

POST /run/sam-3-1/video-rle?wait=20 פּרײַז → ⁨$ 0.19⁩
# 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/video-rle?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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 שליסל

וועגן Sam 3 1 · Video RLE

סעגמענטירט ווידעאָ מיט SAM 3.1, אָנגעהויבן מיט אַ טעקסט־`prompt`, פּונקט־ אָדער קעסטל־פּראָמפּטן, אָדער אַ `mask_url` וואָס ווערט געווענדט בײַ `frame_index`. `max_num_objects` ערלויבט 1 ביז 128 נאָכגעפֿאָלגטע אָבדזשעקטן. שטעלט `return_object_rles` צו באַקומען דעם אייגענעם מאַסקע פֿון יעדן נאָכגעפֿאָלגטן אָבדזשעקט אין יעדן פֿריים מיט אַ סטאַבילן ID. `detection_threshold` גייט פֿון 0.01 ביז 1.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
video_urlפארלאנגט video
טיפּurl · video
ווידעא־URL פֿאַר סעגמענטאַציע.
mask_urlאָפּציאָנעל mask
טיפּurl · image
מאַסקע־URL פֿאַר דער ערשטער אָנווענדונג.
promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
סעגמענטאַציע־פּראָמפּט וואָס שטיצט עטלעכע נאָכגעפֿאָלגטע אָביעקטן דורך באַשרײַבונגען צעטיילט מיט קאָמעס, למשל 'person, cloth'.
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[]
סטאַנדאַרט[]
רשימה פֿון קעסטל־פּראָמפּטן, מיט אַן אָפּציאָנעלן frame_index פֿאַר יעדער פּאָזיציע.
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
סטאַנדאַרטfalse
צי צו לייגן אַ מאַסקע אויפֿן ווידעא.
boundingbox_zipאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
צי צוריקצוגעבן אַ ZIP־אַרכיוו מיט באַגרענעצונגס־קעסטל־איבערלאַגעס פֿאַר יעדער ראַם.
detection_thresholdאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.5
0.01 – 1
שוועל פֿאַר דער דערקענונגס־צוטרוי מיט סטאַנדאַרטן פֿון 0.5 פֿאַר עקזיסטירנדיקע אָביעקטן און 0.7 פֿאַר נײַע. אינעם גרענעץ פֿון 0.0–1.0 געבן קלענערע ווערטן מער דערקענונגען אויפֿן חשבון פֿון פּינקטלעכקייט; פּרוּווט 0.2–0.3 ווען טעקסט־פּראָמפּטן אַרבעטן נישט.
frame_indexאָפּציאָנעל
טיפּinteger
סטאַנדאַרט0
אינדעקס פֿונעם ראַם פֿאַר דער ערשטער אינטעראַקציע ווען mask_url ווערט צוגעשטעלט.
max_num_objectsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט16
1 – 128
מאַקסימאַלע צאָל אָביעקטן וואָס ווערן נאָכגעפֿאָלגט אינעם ווידעא.
return_object_rlesאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
צי אויך צוריקצוגעבן אַ באַזונדערע מאַסקע פֿאַר יעדן נאָכגעפֿאָלגטן אָביעקט אין יעדן ראַם, מיט אַ סטאַבילן אָביעקט־ID דורכן גאַנצן ווידעא. דער ענטפֿער נעמט ווײַטער אַרײַן דעם צונויפֿגעפֿירטן rle.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/video-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": 190,
    "usd": "0.19",
    "charged": 190,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "boundingbox_frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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 איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
video
object {url, content_type, file_name, file_size}ווידעא געשאַפֿן דורך סעגמענטאַציע.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP־אַרכיוו מיט באַגרענעצונגס־קעסטל־איבערלאַגעס פֿאַר יעדער ראַם.

מער מאָדעלן: ווידעא צו ווידעא

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/sam-3-1/video-rle.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt