Sleppa yfir í efni

Sam 3 · Video

Tengja

Auðkenni líkans 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"

Skrár eins og dæmið: 0,095 $ 95 API-inneignir skrárnar þínar eru mældar áður en keyrt er Keyra á þessari síðu

Fá API-lykil
Meta Myndband í myndband #segmentation#mask#real-time

Greinir og rekur hlutverk í myndbandi út frá texta-, punkta- eða kassaleiðbeiningum og skilar myndbandi með grímu

Meta · Myndband

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

sjálfgefið

Kvaðning fyrir hlutgreiningu sem styður mörg rakin viðföng með lýsingum aðgreindum með kommum, til dæmis 'person, cloth'.

•áskilið video_url
Slepptu skrá eða

Slóð að myndbandi fyrir hlutgreiningu.

Ítarlegt text_prompt · video_output_type · detection_threshold · apply_mask · point_prompts · box_prompts

[DEPRECATED] Eldra inntak sem er varðveitt vegna afturvirks samhæfis; notið 'prompt' í staðinn.

video_output_type sjálfgefið X264 (.mp4)

Úttakstegund myndbandsins sem verður til.

sjálfgefið 0.5

Mörk á öryggisskori greiningar; lægra gildi eykur fjölda greindra hluta á kostnað nákvæmni. Bilið er 0.0–1.0.

sjálfgefið []

Safn punktamiðaðra kvaðninga.

sjálfgefið []

Ram{kvaðningar} skráðar sem hnitastrengir (x_min, y_min, x_max, y_max).

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

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Sam 3 · Video

Finnur og rekur hlutverk í myndbandi sem er sent með `video_url`. Nefndu markhlutverk í `prompt`, aðskilin með kommum, eða notaðu `point_prompts` og `box_prompts`. `detection_threshold` er frá 0.1 til 1 og `apply_mask` stýrir því hvort gríman sé teiknuð á myndbandið. Úttakið er mp4 eða webm ásamt zip-skrá með kassayfirlagningum fyrir hvern ramma.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
video_urláskilið video
Gerðurl · video
Slóð að myndbandi fyrir hlutgreiningu.
promptvalfrjálst
Gerðstring
Sjálfgefið
Kvaðning fyrir hlutgreiningu sem styður mörg rakin viðföng með lýsingum aðgreindum með kommum, til dæmis 'person, cloth'.
text_promptvalfrjálst
Gerðstring | null
[DEPRECATED] Eldra inntak sem er varðveitt vegna afturvirks samhæfis; notið 'prompt' í staðinn.
point_promptsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Safn punktamiðaðra kvaðninga.
point_prompts[].xvalfrjálst
Gerðinteger | null
Staðsetning kvaðningar eftir X-ásnum.
point_prompts[].yvalfrjálst
Gerðinteger | null
Staðsetning kvaðningar eftir Y-ásnum.
point_prompts[].labelvalfrjálst
Gerðenum
01
Merkimiði fyrir forgrunn eða bakgrunn: 1 táknar forgrunn; 0 táknar bakgrunn.
point_prompts[].object_idvalfrjálst
Gerðinteger | null
Valfrjálst auðkenni sem flokkar kvaðningar sem betrumbæta einn hlut. Ef texti er einnig gefinn upp sem kvaðning ákvarðar þetta auðkenni hvaða greindi hlutur punktarnir betrumbæta.
box_promptsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Ram{kvaðningar} skráðar sem hnitastrengir (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalfrjálst
Gerðinteger | null
Lágmark x-hnits fyrir reitinn.
box_prompts[].y_minvalfrjálst
Gerðinteger | null
Lágmark y-hnits fyrir reitinn.
box_prompts[].x_maxvalfrjálst
Gerðinteger | null
Hámark X-hnits kassans.
box_prompts[].y_maxvalfrjálst
Gerðinteger | null
Hámark Y-hnits kassans.
box_prompts[].object_idvalfrjálst
Gerðinteger | null
Valfrjálst auðkenni sem flokkar kassa sem betrumbæta einn hlut.
apply_maskvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Hvort beita eigi grímu á myndbandið.
video_output_typevalfrjálst
Gerðenum
SjálfgefiðX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Úttakstegund myndbandsins sem verður til.
detection_thresholdvalfrjálst
Gerðnumber
Sjálfgefið0.5
0,1 – 1
Mörk á öryggisskori greiningar; lægra gildi eykur fjölda greindra hluta á kostnað nákvæmni. Bilið er 0.0–1.0.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
video
object {url, content_type, file_name, file_size}Myndband sem verður til við hlutgreiningu.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-safn með yfirlagðum afmörkunarrömmum fyrir hvern ramma.

Fleiri líkön: Myndband í myndband

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/sam-3/video.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt