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

Sam 3 · Video

אינטעגרירן

מאָדעל־id sam-3/video
# 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/video?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.095⁩ 95 API־קרעדיטן אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

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

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

Meta · ווידעא

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

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

בויען אַ בעטן

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

סטאַנדאַרט

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

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

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

פֿאָרגעשריטן text_prompt · video_output_type · detection_threshold · apply_mask · point_prompts · box_prompts

[DEPRECATED] אַלטע אַרײַנגעבונג געהאַלטן פֿאַר צוריק־קאָמפּאַטיביליטעט; נוצט 'prompt' אַנשטאָט.

video_output_type סטאַנדאַרט X264 (.mp4)

רעזולטאַט־טיפּ פֿאַרן רעזולטירנדיקן ווידעא.

סטאַנדאַרט 0.5

שוועל פֿאַר דער דערקענונגס־צוטרוי: אַ נידעריקער ווערט פֿאַרגרעסערט די צאָל דערקענונגען אויפֿן חשבון פֿון פּינקטלעכקייט; דער גרענעץ איז 0.0–1.0.

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

זאַמלונג פֿון פּונקט־באזירטע פּראָמפּטן.

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

קעסטל־פּראָמפּטן אויסגערעכנט ווי קאָאָרדינאַטן־טופּלען (x_min, y_min, x_max, y_max).

POST /run/sam-3/video?wait=20 פּרײַז → ⁨$ 0.095⁩
# 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/video?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 · Video

דערקענט און נאָכפֿאָלגט אָבדזשעקטן דורכן ווידעאָ פֿון `video_url`. באַצייכנט צילן אין `prompt`, צעטיילנדיק עטלעכע מיט קאָמעס, אָדער ניצט `point_prompts` און `box_prompts`. `detection_threshold` גייט פֿון 0.1 ביז 1, און `apply_mask` קאָנטראָלירט צי די מאַסקע ווערט געצייכנט אויפֿן ווידעאָ. דער רעזולטאַט איז mp4 אָדער webm, פּלוס אַ zip מיט באַגרענעצונג־קעסטל־איבערלייגונגען פֿאַר יעדן פֿריים.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
video_urlפארלאנגט video
טיפּurl · video
ווידעא־URL פֿאַר סעגמענטאַציע.
promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
סעגמענטאַציע־פּראָמפּט וואָס שטיצט עטלעכע נאָכגעפֿאָלגטע אָביעקטן דורך באַשרײַבונגען צעטיילט מיט קאָמעס, למשל 'person, cloth'.
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
אָפּציאָנעלע אידענטיפֿיקאַטאָר וואָס גרופּירט פּראָמפּטן פֿאַר איין אָביעקט. אויב טעקסט ווערט אויך צוגעשטעלט, באַשטימט דער אידענטיפֿיקאַטאָר וועלכן דערקענטן אָביעקט די פּונקטן פֿאַרבעסערן.
box_promptsאָפּציאָנעל
טיפּobject[]
סטאַנדאַרט[]
קעסטל־פּראָמפּטן אויסגערעכנט ווי קאָאָרדינאַטן־טופּלען (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
אָפּציאָנעלע אידענטיפֿיקאַטאָר וואָס גרופּירט קעסטלעך פֿאַר איין אָביעקט.
apply_maskאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
צי צו לייגן אַ מאַסקע אויפֿן ווידעא.
video_output_typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטX264 (.mp4)
X264 (.mp4)VP9 (.webm)
רעזולטאַט־טיפּ פֿאַרן רעזולטירנדיקן ווידעא.
detection_thresholdאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.5
0.1 – 1
שוועל פֿאַר דער דערקענונגס־צוטרוי: אַ נידעריקער ווערט פֿאַרגרעסערט די צאָל דערקענונגען אויפֿן חשבון פֿון פּינקטלעכקייט; דער גרענעץ איז 0.0–1.0.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/video",
  "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": 95,
    "usd": "0.095",
    "charged": 95,
    "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/video.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt