Pereiti prie turinio

Sam 3 · Video RLE

Integruoti

Modelio 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"

Failai kaip pavyzdyje: 0,095 $ 95 API kreditai jūsų failai išmatuojami prieš paleidimą Paleisti šiame puslapyje

Gauti API raktą
Meta · Vaizdo įrašas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

numatytoji

Segmentavimo raginys, palaikantis kelis sekamus objektus, pateiktus kableliais atskirtais aprašais, pvz., 'person, cloth'.

•privaloma video_url
Įmeskite failą arba

Vaizdo įrašo URL segmentavimui.

Išplėstiniai mask · detection_threshold · frame_index · apply_mask · boundingbox_zip · point_prompts · box_prompts
mask_url
Įmeskite failą arba

Kaukės URL pradiniam pritaikymui.

numatytoji 0.5

Aptikimo pasikliautinumo riba, numatyta kaip 0.5 esamiems objektams ir 0.7 naujiems. 0.0–1.0 diapazone mažesnės reikšmės sumažina tikslumą, bet padidina aptikimų skaičių; kai tekstiniai raginiai neveikia, išbandykite 0.2–0.3.

numatytoji 0

Kadrų indeksas pradinei sąveikai, kai pateikiamas mask_url.

numatytoji []

Taškinių raginimų sąrašas, nurodantis kadrų indeksus.

numatytoji []

Langelio raginimų sąrašas su pasirinktiniu frame_index kiekvienam įrašui.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Sam 3 · Video RLE

Segmentuoja vaizdą su SAM 3 pagal tekstinį `prompt`, taško arba stačiakampio užklausas, arba pradinę kaukę iš `mask_url`, taikomą ties `frame_index`. `detection_threshold` reikšmė yra nuo 0.01 iki 1; mažesnės reikšmės, pavyzdžiui, nuo 0.2 iki 0.3, gali padėti, kai tekstinės užklausos neveikia. Gali grąžinti kiekvieno kadro ribojančiųjų stačiakampių zip archyvą naudodamas `boundingbox_zip`.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
video_urlprivaloma video
Tipasurl · video
Vaizdo įrašo URL segmentavimui.
mask_urlneprivalomas mask
Tipasurl · image
Kaukės URL pradiniam pritaikymui.
promptneprivalomas
Tipasstring
Numatytoji reikšmė
Segmentavimo raginys, palaikantis kelis sekamus objektus, pateiktus kableliais atskirtais aprašais, pvz., 'person, cloth'.
point_promptsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Taškinių raginimų sąrašas, nurodantis kadrų indeksus.
point_prompts[].xneprivalomas
Tipasinteger | null
Raginio padėtis X ašyje.
point_prompts[].yneprivalomas
Tipasinteger | null
Raginio padėtis Y ašyje.
point_prompts[].labelneprivalomas
Tipasenum
01
Priekinio plano / fono etiketė: 1 nurodo priekinį planą, 0 – foną.
point_prompts[].object_idneprivalomas
Tipasinteger | null
Pasirinktinis identifikatorius, grupuojantis vieną objektą tikslinančius raginimus. Jei kaip raginys taip pat pateikiamas tekstas, šis identifikatorius nurodo, kurį aptiktą objektą šie taškai tikslina.
point_prompts[].frame_indexneprivalomas
Tipasinteger | null
Sąveikai skirtą kadrą identifikuojantis indeksas.
box_promptsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Langelio raginimų sąrašas su pasirinktiniu frame_index kiekvienam įrašui.
box_prompts[].x_minneprivalomas
Tipasinteger | null
Mažiausia langelio x koordinatė.
box_prompts[].y_minneprivalomas
Tipasinteger | null
Mažiausia langelio y koordinatė.
box_prompts[].x_maxneprivalomas
Tipasinteger | null
Didžiausia dėžutės X koordinatė.
box_prompts[].y_maxneprivalomas
Tipasinteger | null
Didžiausia dėžutės Y koordinatė.
box_prompts[].object_idneprivalomas
Tipasinteger | null
Pasirinktinis identifikatorius, grupuojantis vieną objektą tikslinančias dėžutes.
box_prompts[].frame_indexneprivalomas
Tipasinteger | null
Sąveikai skirtą kadrą identifikuojantis indeksas.
apply_maskneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Ar vaizdo įrašui taikyti maskavimą.
boundingbox_zipneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Ar grąžinti ZIP archyvą su kiekvieno kadro ribojančiųjų langelių perdangomis.
detection_thresholdneprivalomas
Tipasnumber
Numatytoji reikšmė0.5
0,01 – 1
Aptikimo pasikliautinumo riba, numatyta kaip 0.5 esamiems objektams ir 0.7 naujiems. 0.0–1.0 diapazone mažesnės reikšmės sumažina tikslumą, bet padidina aptikimų skaičių; kai tekstiniai raginiai neveikia, išbandykite 0.2–0.3.
frame_indexneprivalomas
Tipasinteger
Numatytoji reikšmė0
Kadrų indeksas pradinei sąveikai, kai pateikiamas mask_url.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
video
object {url, content_type, file_name, file_size}Segmentavimo metu sukurtas vaizdo įrašas.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP archyvas su kiekvieno kadro ribojančiųjų langelių perdangomis.

Daugiau modelių: Vaizdo įrašas į vaizdo įrašą

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/sam-3/video-rle.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt