Hoppa till innehåll

Sam 3 · Video RLE

Integrera

Modell-id sam-3/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/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"

Filer som exemplet: 0,095 $ 95 API-krediter dina filer mäts innan körningen Kör den på den här sidan

Hämta API-nyckel
Meta Video till video #segmentation#mask#real-time#rle

Videosegmentering med mask-URL-initiering, kontroll av bildruteindex och ett lägre golv för detekteringströskeln

Meta · Video

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

standard

Segmenteringsprompt som stöder flera spårade objekt genom kommaseparerade beskrivningar, till exempel 'person, cloth'.

•obligatoriskt video_url
Släpp en fil eller

Video-URL för segmentering.

Avancerat mask · detection_threshold · frame_index · apply_mask · boundingbox_zip · point_prompts · box_prompts
mask_url
Släpp en fil eller

Mask-URL för den initiala tillämpningen.

standard 0.5

Gränsvärde för detektionskonfidens, med standardvärdena 0.5 för befintliga objekt och 0.7 för nya. Inom intervallet 0.0–1.0 innebär lägre värden en avvägning mot precisionen till förmån för fler detektioner; prova 0.2–0.3 när textprompter misslyckas.

standard 0

Index för bildrutan där den initiala interaktionen sker när mask_url anges.

standard []

Lista med punktprompter som anger bildruteindex.

standard []

Lista med boxprompter, med ett valfritt frame_index för varje post.

POST /run/sam-3/video-rle?wait=20 pris → 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-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"

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Sam 3 · Video RLE

Segmenterar video med SAM 3 med en textbaserad `prompt`, punkt- eller boxpromptar eller en initial mask från `mask_url` som tillämpas vid `frame_index`. `detection_threshold` går från 0.01 till 1, och lägre värden som 0.2 till 0.3 kan hjälpa när textpromptar misslyckas. Kan returnera en zip-fil med begränsningsrutor per bildruta via `boundingbox_zip`.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
video_urlobligatoriskt video
Typurl · video
Video-URL för segmentering.
mask_urlvalfritt mask
Typurl · image
Mask-URL för den initiala tillämpningen.
promptvalfritt
Typstring
Standard
Segmenteringsprompt som stöder flera spårade objekt genom kommaseparerade beskrivningar, till exempel 'person, cloth'.
point_promptsvalfritt
Typobject[]
Standard[]
Lista med punktprompter som anger bildruteindex.
point_prompts[].xvalfritt
Typinteger | null
Promptens position längs X-axeln.
point_prompts[].yvalfritt
Typinteger | null
Promptens position längs Y-axeln.
point_prompts[].labelvalfritt
Typenum
01
Etikett för förgrund/bakgrund: 1 anger förgrund; 0 anger bakgrund.
point_prompts[].object_idvalfritt
Typinteger | null
Valfri identifierare som grupperar prompter som förfinar ett enda objekt. Om text också anges som prompt avgör denna identifierare vilket upptäckt objekt punkterna förfinar.
point_prompts[].frame_indexvalfritt
Typinteger | null
Index som identifierar bildrutan för interaktion.
box_promptsvalfritt
Typobject[]
Standard[]
Lista med boxprompter, med ett valfritt frame_index för varje post.
box_prompts[].x_minvalfritt
Typinteger | null
Minsta x-koordinat för rutan.
box_prompts[].y_minvalfritt
Typinteger | null
Minsta y-koordinat för rutan.
box_prompts[].x_maxvalfritt
Typinteger | null
Maximal X-koordinat för boxen.
box_prompts[].y_maxvalfritt
Typinteger | null
Maximal Y-koordinat för boxen.
box_prompts[].object_idvalfritt
Typinteger | null
Valfri identifierare som grupperar boxar som förfinar ett enda objekt.
box_prompts[].frame_indexvalfritt
Typinteger | null
Index som identifierar bildrutan för interaktion.
apply_maskvalfritt
Typboolean
Standardfalse
Om maskning ska tillämpas på videon.
boundingbox_zipvalfritt
Typboolean
Standardfalse
Om ett ZIP-arkiv med överlagringar av begränsningsrutor för varje bildruta ska returneras.
detection_thresholdvalfritt
Typnumber
Standard0.5
0,01 – 1
Gränsvärde för detektionskonfidens, med standardvärdena 0.5 för befintliga objekt och 0.7 för nya. Inom intervallet 0.0–1.0 innebär lägre värden en avvägning mot precisionen till förmån för fler detektioner; prova 0.2–0.3 när textprompter misslyckas.
frame_indexvalfritt
Typinteger
Standard0
Index för bildrutan där den initiala interaktionen sker när mask_url anges.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/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": 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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
video
object {url, content_type, file_name, file_size}Video som producerats genom segmentering.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med överlagringar av begränsningsrutor för varje bildruta.

Fler modeller: Video till video

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/sam-3/video-rle.md. Alla modeller och guider: https://doitong.com/developers/llms.txt