Gå til indhold

Sam 3 1 · Video

Integrer

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

Filer som eksemplet: 0,19 $ 190 API-kreditter dine filer måles før kørslen Kør den på denne side

Hent API-nøgle
Meta Video til video #segmentation#mask#real-time

SAM 3.1-videosegmentering, der sporer op til 128 objekter og leverer output som mp4 eller webm

Meta · Video

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

standard

Segmenteringsprompt, der understøtter flere sporede objekter gennem kommaseparerede beskrivelser som 'person, cloth'.

•påkrævet video_url
Slip en fil, eller

Video-URL til segmentering.

Avanceret video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type standard X264 (.mp4)

Outputtype for den resulterende video.

standard 0.5

Grænse for detektionskonfidens, hvor en lavere værdi øger antallet af detektioner på bekostning af præcisionen; intervallet er 0.0–1.0.

standard 16

Øvre grænse for, hvor mange objekter der spores i videoen.

standard []

Samling af punktbaserede prompts.

standard []

Boksprompts angivet som koordinattupler (x_min, y_min, x_max, y_max).

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

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Sam 3 1 · Video

Segmenterer og sporer objekter i en video med SAM 3.1 ud fra en kommasepareret tekst-`prompt`, punkter eller bokse. `max_num_objects` angiver, hvor mange objekter der skal spores, fra 1 to 128 (standard 16). `detection_threshold` går fra 0.1 to 1. Outputtet er X264 (.mp4) eller VP9 (.webm).

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
video_urlpåkrævet video
Typeurl · video
Video-URL til segmentering.
promptvalgfri
Typestring
Standard
Segmenteringsprompt, der understøtter flere sporede objekter gennem kommaseparerede beskrivelser som 'person, cloth'.
point_promptsvalgfri
Typeobject[]
Standard[]
Samling af punktbaserede prompts.
point_prompts[].xvalgfri
Typeinteger | null
Promptens position langs X-aksen.
point_prompts[].yvalgfri
Typeinteger | null
Promptens position langs Y-aksen.
point_prompts[].labelvalgfri
Typeenum
01
Forgrunds-/baggrundsetiket: 1 angiver forgrund; 0 angiver baggrund.
point_prompts[].object_idvalgfri
Typeinteger | null
Valgfri identifikator, der grupperer prompts, som forfiner ét objekt. Hvis tekst også angives som prompt, bestemmer denne identifikator, hvilket registreret objekt punkterne forfiner.
box_promptsvalgfri
Typeobject[]
Standard[]
Boksprompts angivet som koordinattupler (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalgfri
Typeinteger | null
Minimums-x-koordinat for boksen.
box_prompts[].y_minvalgfri
Typeinteger | null
Minimums-y-koordinat for boksen.
box_prompts[].x_maxvalgfri
Typeinteger | null
Maksimal X-koordinat for boksen.
box_prompts[].y_maxvalgfri
Typeinteger | null
Maksimal Y-koordinat for boksen.
box_prompts[].object_idvalgfri
Typeinteger | null
Valgfri identifikator, der grupperer bokse, som forfiner ét objekt.
apply_maskvalgfri
Typeboolean
Standardtrue
Om maskering skal anvendes på videoen.
video_output_typevalgfri
Typeenum
StandardX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Outputtype for den resulterende video.
detection_thresholdvalgfri
Typenumber
Standard0.5
0,1 – 1
Grænse for detektionskonfidens, hvor en lavere værdi øger antallet af detektioner på bekostning af præcisionen; intervallet er 0.0–1.0.
max_num_objectsvalgfri
Typeinteger
Standard16
1 – 128
Øvre grænse for, hvor mange objekter der spores i videoen.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/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": 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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
video
object {url, content_type, file_name, file_size}Video produceret af segmentering.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med overlays af afgrænsningsbokse for hver frame.

Flere modeller: Video til video

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/sam-3-1/video.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt